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PREFACE [ • | 

DOS XL ia th« rasult of tha afforta of aavaral n.r.on. 

and wi balieva that propar cradit ahould b« glvan. ' Tha ! 

orlginJl v^iln" /°* **? COn ;2!* proc.a.or (cp) and tha i 

Sv.ta» ? ( r C,1 ° n * } 01 th * «»•' Hanagar r 

2 es) wlrS Srfc * our **' identlc »* Wth Atari-a DOS f • 

2 -esj war« writtan by Paul Laughton. Tha currant 1 


H!rk i0 Ro..* * X i P°f tlon * ar « priaariiy tha iork of 

Wllhiu^o Jik° pltar.. 0 ' ^ C ° U * b0 ^ ti0n ° f Bil * 


SERVICE AND SUPPORT POLICIES ' 


vff r !:*^ WOrke ? t0 bring V ou producta which will giva you 
y ara of aarvica and enjoyaont. Aa with anv aoftwara 

occur* 1 * Yo^ <1UCt ' though ' • rror » or Odiaaiona can and do 
nr^hf' Y ** Y ro,t that, if you hava a 

probla«, «Vary raa.onabl. affort .hall b.'aadS to h.lp 

atoHt*Ms'xL V tö ObI dl « ect 9U - ti ? n « •"<1 probla« r.port. 

V" to 0sfi - Howawar . ainc. DOS XL ia only 
diatrlbutad aa a licanaed ' product, you muat alqa and 

packaua^Ifor 8 Llc * n "* Agreomant Included in your DOS XL 
packaga bafora wa can raapond to your inguirias. 

U you hava a guick guaation or aiaply * ncocadural 
probla», you »ay call th. t.chnic.l lupport atl« It 
0S3. In ord.r to allow our par.onn.l tim“ to an.wir 
l * bt *f*» raaaarch your problena, and aat lunch wa muat 
9U0 t AM t to°N O i 1 “ lt i°m technical call, to th. hour. of 

olLST ° r n 1 * 30 PH 4 *30 PH (all tiaaa Pacific 
Tina, pl«a„). ^Oor ^Jachnical aupport ouabar 1. 

unuaual^to^f lnd*n>*** V *% i ** vor4 i Phon, linaa. it 1. not 
t^? ägiin? * U bU,y * Pl «" b - P*tiant and 

und.r«fand that our aupport ataff ha. only 

aiäitTnnI*7° UrC J* ? nd BOt b * * bl * to anawar all your 

u luch thit ! *:- lnut * P hon * «11* So. It your p^ob?« 

tö wil iS ri!tiär n and e fn^. t S •« invit.C 

A a** Ana inciud« A di»k#ttA or 

printout datailing or daaonatrating your dlfficulty 

Plaaaa usa tha addraas glvan on th« pravioua pag«. ** 

AtT-l lf /OU *** 1 th * Probla«. 11., ln th. dl.k driv. 

dtlli ' Rif« = E5 i th- i Jlt r U l ltm th * '“"“«•otur.r of your 
driil to th. litaratur« you racaiv.d with you* 

driv« for tha appropriat. addraas and phon« nuabar. * 




ABOUT THIS EDITION 


Byataas p^uSSS bJ'&LiS« 

co.npiat.iy fil. coropatibl« ii t {|- r ' Ct ,uoc ««»« to and 
Atari OOS 2.es 

OB/x! *•« 

OS/A-t varaion 2.1 

Dos XL varaion 2.2 

whii -: d ^ on u o Lti h : u ^.^rr l . h *; b : ,n •• 

5 S 

Ärtir & “x 

daflnitaly raad ch.pU*^ pro ®” , **r, you ahould 

Manual bepore you atart ua« il 


•ugga.t°r..diig‘thä*ritiiJ P r ?«r*<«*lr. «a would 

attantion to chaptar 10. Manual, paying apacial 

:;rf n ! 11 *! you wouid iik 


• llowlng^it to dj 0 “,.^«! taaka ^ 4Uto -«td DOS XL, 

coaputar i. unatt.nd.d, y^^.d^ /.% JT 


Ojf courii, rtgardlaid _« 

P^Po.aa, if J ou g. t tir.d y o# r th* ,,,, * r ** nC# Uw#I ®r 
Mifht L aT*J| U ' you 4ho “l<l r*id d chait«ri**i rlct i°"5 ot tb * ' 

»i3ht find thaa «hlightaning. Pt 5 * r * 1 *• »ou 


S 9uld - 

i»pacrth^ nu :i; b .j r * c «^}[' b *ipfui •nd*c. 9 r 9 "“ u °; h - 

alway. w.lcom«. 1 coamank«. y OU r l.tt.rs ar. 
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Valid fila nameat 
GEORGE 
TEMP.ABC 
PROCl.SAV 
SORT123 
COpy.COH 


Illegal fila naaaai 
HAMETOOLOua 
TEHP,. LOHGEXTEHS ioh 

lor?iä 3 AV |f t * rt * «*th digit) 
aortl23 (lower caaa lattera) 
BAD-CHAä 1,1 


•* «*• <u. ...i 

Ä. STSK 1 3*Sä'““ 

,u - tn.i.uo u **♦ 


*“99.«atad uaage.' 

frc *SAVE*d BASIC fila 

• • LIST*ad BASIC fil. 

W65 ACTIOHi aourca fila 

OBJ "f AVE *d *««/«* fila 

cnH binary object fila 

ty c J*? s XL “tility program 

SYa 003 XL axacuta fila 

spatem program - rsaarvad 


Bxamplai 

GEORGE.SAV 
PR0G1.LIS 
MIKE.ACT 
8ORTI.H6S 
BILL.OBJ 
C0PV.COM 
STASTUP.EXC 
for DOS XL 


spacifi.r whlch U taÜ“ thä b * t pr * c, “« <1 b V » d.vlce 

search for . p^ticuui f . ° n whlch «*iv to 

apacifier is. tlCUlar fU *' «»? *>™*t of « davica 
Dm 

(or) 

Di 

drivaa you have.^If^oMult 10 ^apending on how many 
...um.d y (thi.1. D ’' driv * 1 

driva). Hera ara aeveral axamolaf X#** on *y bava one 

..... „. ... ...id „p. th „ 


Fila nanai 

Dl 1 GEORGE 

D2.HIKE.ACT 

d.temp.lis 


Haaningi 

fila GEORGE on driva 1 
fila HIKE.ACT on driva 2 
fila TEHP.LIS on driva 1 










In lau« caia« fiip name« may contain tha *wild-card" 
charact.ra •?* and A quaation »ark {'?•) 

will a>atch any charactar in f fila nam«, whila an 
Af^trlik (*^*i will match any fltirlng o{ ^«ro or nora 
charactar*. For «xampi«, AB«.C7? will Batch 
ABX.CXX AB.CUR ABCDEF.CNM #tc. Hild-card charactara 
*ay )>. uaad in tha following DOS XD *>*nu c omma nd«i 
Fila« on Oiak 
Copy flies 
Braaa Fila« 

Protect File« 

Unprotact Files 

Saa »ection 3 for »or« Information on thaaa nenn I 
coromand«. Saa «ection 5 for »or« on "wild-carda*. | 


1.4 Other davice« 


Th« Atari personal Computer conaidar« evarything «xcapt 
tha gut« of tha Computer (i.a. 4 ha RAH, ROM, and 
proceaslng Chip«) to ba extarnal dovica«. Actually, 
•oma of thaaa “axternal davice«* cooa with tha Computer 
(for «xample, tha Keyboard and tha Screen Editor). Sone 

th * ? ther J . do Y ice * *r« Drive. Program Recorder 

(caaaetta)* and Printer. Whan proraptad for a fila nana 
by DOS XL, you need not alway« antcr tha nara* of a dlak 
fila. Othar devica« are referred to by namaa coneiating 
of 4 single lettar optionally followed by a «ingl« digit 
uaad to defin« a «pecific devica whan »or» than , one of 

*;• 1 J t (- - 9 ;* Dl * OC DJ «>- davice nam« 

»uat ba followed by a colon. Th« following 1« a Hat of 

davic« name« which may ba uaad undar atandard DOS XL« 

c« Th« Program Recorder — handle« both Input 

and Output. You can u«a tha racorder aa 
«ithar an input or output davic«. but navar 
both m imultanaoualy. 

01« - DB. Dlak Privat.) — handl.« both Input and 
Output. Unlike C«, diak drlvaa can be uaed 
for input and output aimultanaoualy. You ara 

2 i^ r#qUlr,,d fc ? «P? cif T * *llm name with thia 
a*vic « 4 m provioualy mention«d. 

HOTE. if you uaa D. without a driv« number. 
Dl« ia aaaumed. 

E. «creen Cd i^ or " handle« both Input and 

Output. Th« acreen aditor aimulatea a taxt 
aditor/word proceaaor uaing tha kayboard aa 


input and tha diaplay (xv or Monitor) aa 

tun? 06 " , Thl * i * tha editor you uaa whan 
typing in a BASIC XL prograa. Whan you 
»pecify no channal whila doing I/O, Ei i«. 
uaedbecauaa tha channal dafault« to 0 , which 
ia tha channal BASIC XL opana for Ei. 

K * Kayboard — handlaa Input only. Thia allowa 

you acceaa to tha kayboard without uaing Ei. 

P * Parallel f oct on th# 850 Modul« — handlaa 

0 ut P“ b , onl y* Uaually p« i t US ad for a 
Printer, ao it haa com« to »«an 
Printer* aa wall aa ‘Parallel Port*. 

RXi - R4i Tha four RS-232 Serial Ports on tha Atari SS0 
Interface— handle both Input and Output. 
Thea« davice« anabl« tha Atari ayate» P to 
intarfaca to RS-232 compatibla aarial davic«« 
lik« terminal«, plottera, and »odema. 

NOTE» if you uaa Ri without a devica numbar. 
Rlj ls aeaumed. 

®* Th« Screen Diaplay («ithar TV or Monitor) ~ 

handlaa both Input and Output. Thia davic« 
allowa you to do 1/0 of eithar charactar« or 
graphics polnts with tha screen diaplay. Th« 
Cursor ia uaed to address a acraen position. 


0 


<ß 0 


1.5 DOS XL command mcxJ«*» 


m T of D0S Ä U u ' two “ od - ° e ce»»*nd 

r cLmanS * U ’* r ' roay Cl "°** «ithar a manu »od« or 

proceaaor. For tho«. of you unfamlliar with 
Ü U ff iv8n «y»teraa auch aa Atari DOS, a manu ia 
yL^LA. 11 ?* co<m " and « which appoar on tha acraen. 

you. f : d P LL h °°!' ? n ! of *?• °P tion * ü«ted baför« 
\ .. additional Information ia raquired. you «r« 

vo« ther P rom P t * <5 b y tha System for input.* In thia way 
you need not remember tha namaa of DOS functionll 
inataad, you may «impiy «al.ct a command from tha Uat. 

p£l-- th * r lnp ü t mod * for 003 command« ia tha Comand 
n ’° d !' or " Cp ** In thia mode, you ar« NOT 
mu.iT 1 ? 11 f t of command« to choos« from. Inataad. you 
reicht 003 conuaand » b Y n ' UB «" Although thia 

been ccJLifJflÜ ,* cumberaom«, »"C. aavaral command« hava 
f«t.r^ni t,<ä ? memory, tha command mod« 1. BU ch 

f«tÜL. tD A1, °' c.rtain advancaS 

featura« of tha DOS ar« evallabl« only from th» *CF*. 


0 







I Whan DOS XL ia ahipped to you, it ia aat up ao that 
I you will ba preeented with tha nanu moda of command 
I entry. It ia recommanded that thia moda ba used 
I excluaively until you hava gained aoaa faailiarity 
I of tha ayatem. Ät that tiraa you may, if you wiah, 
t read carefully aactiona 4 and S which diacuaa uaing 
I tha DOS XL command proceaaor. After trying out tha 
I command mode, you may refer to aaction 8 in Order bo 
I modify tha ayatea ao that tha command proceaaor 
I appeara by default inataad of tha manu. 


The following aaction aumraarlzea tha differencea betwean 

the manu and command modea of DOS XL Operation. 

The DOS XL manu haa tha following advantagaa and 

diaadvantagaai 

Advantageai 

1} You do not nead to remember tha namea of DOS 
commanda. Inataad, you ara prompted at aach atep 
for tha proper Information. 

2) Thoae of you alraady familiär with Atari DOS 2.Sa 
may find tha DOS XL manu mora comfortabla and aaaiar 
to uaa. 

Diaadvantagaai 

1) Uaing tha manu with DOS XL uaea about 2K mora memory 
apaca. Howevar, thia ia offmet by tha fact that DOS 
XL aavea you 5K with a aupercartriBga. 

Tha DOS XL CP (conunand proceaaor) haa tha following 

advantagea and diaadvantagaai 

Advantageai 

1) Onca a faw commanda hava baen learned, tha command 
moda ia faater to uaa than tha manu moda. 

2) Thoae of you familiär with other oparmtloy vyatema 
auch aa Apple DOS. CP/M, UW*, or 0S/A4- will find 
tha command moda mora convantional and faaiiliar than 
tha manu moda. 

3) Unlik« the nanu mode, the DOS XL command proceaaor 
use« no «ztra uatr momory. 

Diaadvantagaai 

1) You ara not promptad for input aa in tha manu moda. 
Therefore, you muat learn aavaral fundamental 
commanda in ordar to utilite tha powar of tha 
command moda. - . 
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l : < OverVie w of Ms'xZ'ÄrchuIcIürl 


concapt which ia built^around 1 * ? ut iU*ea a aoftwara 
achema. i„ particular * «iructurad and layarad 
«xpactad to maka call, to tha * ro *«*» *t* 
output routina Ccio*) r °? 1 th * c *htrai Input 
which axaminaa thi a? P U C atJon nr* CX °. U * «•*•*«*•* 

in *«» «u th . 
channal comauAicatioJi. with l d!\ p#r, °™ th « »ctual 
(obvioua «xcaptiona includi^v^ lc *“ on th * ••«’ial bua 
which do not requira aarial * cr **® *nd kayboard, 
d.vic. (on th. .2rial buO^ l.cX v i: CV t i Cm l; n Fi ““y. th. 
perfarma tha . actual 1/q n^dld th. 810 raqua.t , n4 
iliuatratas thi. procaaa. ^ d * Th* diagra« balow 


® 0 



ä. »«!.. 
“r ■ -r »"r s;rJ:; 

• 810 J (Atari kayboard) iTV/mclltor) 


I ] 

(di.k driv.) (printar) 


„ Figura 1-1 
Ovarview of DOS XL 
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Genarally apeaklng, thara ia no reaaon any One or aor« 
portion» of thia hierarchical atructur» cannot ba 
replaced with anothar, äquivalent aaction Of Code. On 
tha Atari Computer, ln fact, DOS 7CL itaelf (or for that 
matter any othar DOS) ia “added“ *o tha dafault 
atructure only if a diak driva ia present a£ powar-on 
tima. Soma manufacturera, for axample, hava producad 
thelr own printar or acrean drivera, replacing tha 
Atari-supplled drivera with aiinimal affaot. 

Unfortunataly. wa cannot aiy that any givan portion may 
ba replaced with HO affect, aimply bacauaa an 
unfortunataly high portion of aoftwara written for tha 
Atari violatos tha (tierarchy (by diract call# to davica 
routines, or woraa). Theaa violatora ara by no meana in 
tha majority, or wa might hava no hope of avar producing 
an lmprovod Atari ayatem. Howevar. wa ahould ba awara 
of at laaat tha moet important of theaa (quite frankly) 
poorly thought-out programa and malntain what 
compatlbility that wa can when wa changa tha ayatem. i 

General ly, tha worat offandera ara programa euch aa 
yiSICALC and MICROSOFT BASIC (diak Version), both of 
wnich maka aaaumptione about meraory layout and diak 
ueaga. Bowavar, theaa programa (and moat othera) ara 
ahipped with an operating ayatem intact on tha diak on 
which thay raalda. Thue. although we may not force them 
to taka advantaga of tha axpanded capabilitica that our 
device drivera may offer, at leoat wa need only malntain 
compatlbility with a atandard Atari-810 Diak Driva to 
allow thelr uaagf on otherwlaa improvad producta. 

Aa you might hava notod ln'Figura l-l, tha manu and CP 
(Coneole Processor) ara HOT privelegod parta of tha 
ayatem. CP functlona aa an aaay-to-uaa Interface 
betwean tha human at tha keyboard and tha machine level 
of tha CIO calia. and tha manu providas an evan almpler 
acceaa into CP and'from thera.to tha raat of tha ayatem. 


1.7 Glosaary of taraa 


Tha following tarme ara uaad throughout tha raat of thia 
manual. Thelr daflnitiona ara included hara ao that you 
may famillarixe yourealf with them bafora proceoding. 
Pleaae refar back to thia aaction to clarify concapta 
introducad latar ln tha manual. 


-07— 


Tarmt 


Dafinitioni 


DOS 

boot 

bootlng , 

• • • 

maater diakatta 
■aatar diak 

bootabla diakatta 

fila nana 

filaapec 

prompt 

. £ RETURN) 

Utility 

Utility program 


An acronym for Diak Oparating 
ayittfla 

Tha procaaa of loading DOS XL or 
anothar ayatem into »emory whan 
you power on your coaiputar. 

Tha DOS XL diakatta you received 
with your purchaaa of DOS XL, or 
a duplicata tharaof. 

Any diakatta which contains tha 
fila DOS.SYS. Such a diak can 
ba uaad to boot DOS XL into 
■emory. To taka advantaga of tha 
you a-lao need DOSXL.SYS on that 
diakatta. 


Tha string of charactars uaad to 
refar to a specific fila on a 
specific driva (a.g., DiGEORGE). 


A fila name which »ay contain 
tha wild-card charactara *7* 


and •** (a.g., 

D2i* *C0?)• 




Any mesaaga frora DOS XL 
instructing or aaking you to 
type a reaponaa. 


Tha key locatad on tha right 
aide of tha keyboard -of your 
Atari Computer, narkad “RETURN*. 


A program which ia uaad by DOS 
XL to perform a diak Operation. 
Examplea lncluda COPY.COM, which 
coplas filasi INIT.COM. which 
initlalizes diak», etc. From 
tha Viewpoint of DOS XL, aven 
languagea auch aa BASIC XL and 
Atari BASIC ara utllitlaa. 
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Section 2| GETTING STARTED WITH DOS XL 


2.1 Booting your DOS XL master dlak 


Th« first Operation you ahould perform aftar opening 
your DOS XL package is to fill out your licensa 
agraement and mail it to OSS. Thle actlon puts you on 
our mailIng liat for a quarterly (uaually) newsletter 
announcing new producta, Updates to axiating producta, 
aolutiona to Problems with our producta, and answers to 
common uaer queationa. 

Onca thla la done, you ahould determine whether you wlah 
to uaa tha single denaity or doubls density veraion of 
DOS XL. In truth, you will probably find occasion to 
uaa both varaiona, ao OSS haa provided you with a 
tvo-sided master diakette. One aide of your DOS XL 
master diakette containa a aingla density Version of DOS 
XLf tha other aide containa a double denaity veraion of 
tha aame thing. But why use ona veraion over tha other? 
There may be many reasons for chooaing ona Version over 
another, but allow us to giva you what wa feel are a faw 
good reasonsi 

SINGLE DENSITYi To be compatible with diskattes created 
or deaigned for Atari 010 disk drives, you ahould uaa 
tha aingla density veraion. Single denaity DOS XL ia 
completely file compatible with Atari DOS 2.0s. All 
Operation« which work with Atari DOS will ganarally work 
with single density DOS XL. 

Ara thera exceptlona? Yea. Saveral Companies produca 
«elf-bootlng disks (that ia, you aimply put them ln tha 
disk drive and turn on tha Computer) which maka call« or 
references to routines or addreaaes internal to Atari 
DOS. Thera ia nothing wo can do to maka DOS XL 
compatible with thesa dlakst On tha othar hand, thia is 
not really a problem, ainc« (as wa mentioned) theaa 
,disks ara generally aelf-booting (implying that they 
include a copy of Atari DOS on thair diak). To uaa 
thesa diskattes, do nothing special. Simply follow 
thair manufacturers* diractions. 

DOUBLE DENSITYi Generally, most programs wrltten with 
cartridga-baaed languages will work fina with doubl« 
denaity DOS XL. Thia uaually includes programs writtaa 
in Atari BASIC, PILOT, LOGO, OSS BASIC XL, HAC/65, C/65, 
and mora. Of course, if you yourself hav« written tha 
program and have not made assurapticna about tha aixa and 
typ« of disk, your programs will run correctly. 


What doean't worw , 

aaauma that aactor« .»II doubl * denaity? Program« which 
Programs which <or *») byt.^ 
enti «eherne.. 

- ia ««.. 

r 3u " ,< At»?i r eiäput« V *,on *"*■ oth . r P.rtph.r.l, 
inatructiona. P following tha manufacturar's 

tel«vi«i on ^ OUr por *P h «r»la and your monitor or 

ff"" .up“ s .s,r:":'««»-»... cp«... ... 

di.k drive (drlv^ i .^ oubl * denaity) i n to tha 
drive). ,ariv * 1 YPu hav. mora th.n on, 

51 if *°“ into tha 

Finally, turn on your Atari computar. 

diak drivt will v._ 

OOS XL co P y rl9h “ B ^.^ b «;^. *«d aftar a tim. th . 

lln!*"* . P**"» * ““•• a 9« 9 will beoin t0p ot tha 
Jlna. which begina ulth »u , 9ln io appear, ll n « bv 

lin. fro« tha atartun ,V? lC ? ra * to *°* XL...-. 
a command which ln.f! ** i u,t This ia 

“*nu. Aftar a few i"!! rUCt * °° S to lo.d th. DOS x£ 
finiah loading. tha acreln^u*' *!*? "*?“ pro9r ** will 
XL menu will appear. 111 9 * ia claar, and tha DOS 


I fro« a r °ipici«l*|a“ h1 ^ *fh** r J on th * • c r*«n cc^Iä” 
} STARTUP.EXC*. In «action^** dl,k whlch i» named 
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Saction 2 1 GETTING STARTED WITH DOS XL 


2.1 Booting your DOS XL nutir diak 


Th« firat Operation you ahould parform aftor opening 
your DOS XL package ia to fill out your licena« 
Agreement and mail it to OSS. Thia action puta you on 
our mailing liat for a quarterly (uaually) newaiettar 
announcing new producta, update« to «zlating producta, 
aolutiona to problema with our producta, and anawara to 
common uaer queationa. 

One« thia ia done, you ahould determine whether you wiah 
to uaa tha aingla denaity or double denaity veraion of 
DOS XL. In truth, you will probably find occasion to 
uaa both varaiona, ao OSS haa provided you with a 
two-aided maater diakette. One aide of your DOS XL 
maeter diakette containa a aingla denaity veraion of DOS 
XL t tha other aide containa a double denaity veraion of 
tha aame thing. But why uae ona veraion over tha other? 
There may be many reaaona for chooaing ona veraion over 
another, but allow ua to giva you what wa feal ara a faw 
good reaaonai 

SINGLE DENSITYi To ba compotlblo with dickattea created 
or deaigned for Atari 610 diak drivea, you ahould uae 
tha aingla denaity veraion. Singla denaity DOS XL ia 
completely fila compatlble with Atari DOS 2.0a. All 
operatlona which work with Atari DOS will generally Work 
with aingle denaity DOS XL. 

Ara thera exceptlone? Yea. Saveral companlea produce 
aalf-booting dieka (that ia, you aimply put them in tha 
diak drive and turn on tha Computer) which make call« or 
referencea to routinea or addreaaea internal to Atari 
DOS. Thera ia nothing wo can do to make DOS XL 
compatibla with theae diakaI On tha othar hand, thia ia 
not raally a problem, ainca (aa wa mantioned) theaa 
,diaka ara generally aalf-booting (implying that they 
include a copy of Atari DOS on thair diak). To uae 
thea« diakettea, do nothing apacial. Simply follow 
thair manufacturera* diractlona. 

DOUBLE DENSITYi Generally, moet program» written with 
cartridga-baaed languagea will work fina with doubl« 
denaity DOS XL. Thia uaually includea programa written 
ln Atari BASIC, PILOT, LOGO, OSS BASIC XL, MAC/65, C/65, 
and mora. Of courae, if you youraelf hava written tha 
program and have not mad« aaaumptlona about tha aiza and 
type of diak, your programa will run corractly. 


What doean t work in doubl« danalty? Program« which 
aeaum« that ««ctora alway« contaln 128 (or 125) bytaa. 
Programa which ara aalf-booting and which hav« apacial 
protaction «eherne«. Program« which bypaaa DOS 
entlraly. Aa mantioned abova, though, thaa« programa 
ara uaually distrlbuted on aalf-booting diaka, ' ao you 
nead do nothing apacial with them. £ 

In any caae, once you hava dacided which danaity diak to 
^°°t. parfona the foilowing atapai 

1) Connect your diak driv« and any othar parlpharals to 

¥° u f Computer following tha m&nufacturar'a 

lnatructlona. ■ ■ ■ 

2) Turn on your perlpharaia and your monltor or 
televialon. 

3) Insert the DOS XL master diak you hav« choaan to uaa 

At or doubl« danalty) into tha 

dr"v«) driV * * drlv * 1 you hava aior« than on« 

4> cartrldg«*, lot. CÄrtrl119 ** “ y °“ Wi ‘ h ‘ th * 

5) Finally, turn on your Atari Computer. 

doc d vr k drlw * w * u b “ accaeaed, and aftar a tim« th« 
^ Copyright maaaaga will appear at th« top of tha 

lin«*"*wh£!h n '>,* “ l i l b * 9 ln to appear, iin« by 

l.II'ii » h be ? in “ wlth Welcome to DOS XL...-. The 
aat Une fron the atartup file la juat "MENU*. Thia ia 

* „ 1 < r°"“ n ?" d whi ^ h inetructa DOS XL to load th« DOS XL 

BOr * »econd«. th« manu progre« will 

XL min lo ?ff n9 ' th * *«••» «iU ciaar. and th« DOS 

manu will appear. 


I lli ? , whlch *PP«*r« on th« acrean coena« 

"STAR^Up'rJri* 1 °? th * dl,k which la "»»*<* 

nllul “f;“® * ln • octlon 8 - 3 . y°“ can laarn how to 
‘“•»•«9«« or omlt tha» entlraly. 


C 0- 
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2.2 Sslecting nanu Option» 


y ou »hould now b« pra»antad with tbs DOS XL nanu on th# 
»craan. It sboul<i iook likf thi»i 

POS XL MEWJ var»lon 2.3f 

Copyright (tc) 1983 OSS, Jnp. 

rilof on Disk Protact filas 
To Cartridge Unprotact Ella* % 

Copy filo» Renan» Flip 

Dupilcot» Disk Save Binary 
Erase Fiias Load Binary 

InitialU* Disk Go to Address 
Xtandad Conmand Quit to DOS XL 

Entar your aalaction. 


I BOTEt If ths' Version nunbar shown on your nanu i» I 
i 2.31, 2.32, etc., thera ls no causa Cor alana. OSS I 
I resarva» tha last digit of th» rsvision nunbar aa a I 
I -patch" nunbar. Patchas novar includa najor I 
j docunantation or featura changa# but instaad only I 
4 fix bug» found in prior ralaasas. t 



Although thls diagran doas not ahow it, tha First 
charactars of »ach of tb» 12 commande in tha list ara in 
invers» vidao. These charactars ara thoae which you 
vould type to salact a command. For exampla, to invoka 
tha "Renan» File" command, you would almply type *R*. to 
tha abova prompt. For nost of tha nanu connands, aatra 
input is raguired. Tha nanu prompt you wIth 
appropriata massage» whenever you ara racjulrjid to input 
rvew data* 

Whentvtr you ar« procnpted by tb« DOS XL »onu to «nt«r » 
filenana or a filaspac, you don't always hava to apecify 
tha davice nana for tha driv». If you do not apecify a 
devica nam» (i.a., Di, D2i, etc.), driv» 1 is assumed 
(Dli). For axanpia, if you typad "GEORGE* as » 
filenama, th» nanu would aasuna. that you naant 
"Dl«GEORGE". 


I CAUTXOB« In general, you nay not omlt tha drlva 
j »pacifiar on names entarad whila using cartridg» 

I basad producta such as Atari BASIC or OSS BASIC XL. 
Except when working with th» manu or DOS XL » 
Consol» Processor, you usually naad to spacify th» 
I entira fila nana (and often auat anclosa it in 
j quotes, as in Atari BASIC). ,; 
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2.3 File» on tha DOS XL nastar~diak 


t0 in,ur * th « integrity of your DOS XL aaatar 
diakctta, you «hould view th« name* of th« ILlmm 

SSlSSlnth 11 * Th * 003 Ä ««« •* SS-M 2 

Entar "your "salaction!)* MnU w111 ^ 

^irst command in tha nanu is "Files on disk". Thla 

command allows you to view tha namas of disk fiUa. 

drivi n ? Ur V that ?°" r 008 ^ diakatte is stÜl 

ln driva^l. ^Then sslact^thi* command aa follows« 

ÄS h ^: n CR«Ä“ by p ^ pti ° 9 “ iu * 

“H JarÄ/p.-ssü'i as-TK,.- 


DOS 

SYS 

046 

DOSXL 

SUP 

046 

DOSXL 

XL 

060 

MENU 

COM 

025 

CLRDSK 

COM 

023 

COPY 

COM 

075 

DO 

COM 

003 

OUPDBL 

COM 

011 

DUPDSK 

COM 

011 

INIT 

COM 

006 

imitdbl 

COM 

023 

NOVERIFYCOH 

001 

RS232 

COM 

001 

RS232PIXCOH 

002 

SDCOPY 

COM 

086 

VERiry 

COM 

001 

SVSEQU 

ASM 

022 

HEH 

LIS 

066 

STARTUP 

EXC 

003 


160 FREE SECTORS 


0t tllaa lo °*» assentiaily tha aama. but 

I is shown * r vr» rlght * ld# ar * about half what 

of J V " bo ? t,d th * ttoubts Dsnaity vsraion 

I « ms In P s^s «3"' “ th " rlr,t liM r “ d * 

I den.itC" ,Ur K that yOU ar * w °rking in doubl. 

fill 1 number on th. right indicate. tha 

hold Slnc * doubl» denaity sactora 

d!n?itv . le ? 0r ° tha " twlc * “ “ uch >• «ingl« 

I srll “ma!lfr 0,r *’»f t ***“ f**“ that th « fU « •*«•« I 

I sector«:- A1 *°> notice how nany mor# "FREE I 

I „n^v^ 3 v.?° U bav * in doubl * denaity. THIS is why 

I you bought * doubl« denaity driv«! * | 
















Each of tha filaa ha» a primary narae and an axtanalon. 
For axarople, tha fila COPY.COH haa primary nama COPY and 
axtanalon COM. Nota that in tha Fila Hat Ing tha pariod 
i« not ahown. Inatead, thera may bc ona or mora apacaa 
between tha primary nama and tha axtanalon. Thia formet 
appaara ONLY in tha fila liating. You may navar uaa 
thia form for apecifying filea. If you ara ualng fila 
extenaiona, you muat uaa • pariod with no intervaning 
apacaa, aa in "DiTEST.LIS*. 

tfotica that all of tha filaa on tha maatar diak axcapt 
tha fila “STARTUP.EXC“ ara praceded by an aatariak in 
tha diractory liating. An aatariak pracading a fila 
impliaa that it haa baen protacted from modification or 
araaura through tha uaa of tha DOS XL manu command 
"Protect Filaa*. Thia method can alao ba uaed to 
protact your own filaa from changa or dalatlon through 
accidental uaa of ona of tha DOS XL commanda (aaa 
aection 3.9 for further Information). 


3.4 Backing up your DOS XL maatar diak 


Now that you hava auccaasfully bootad your maatar diak, 
you ahould make a backup copy. If your DOS XL maatar 
di»k ahould aver fall to operata properly, you may than 
tranafar tha filaa on your backup copy to tha maatar 
disk, thua raatoring tha maatar to a working atata. 

Firat, for aafaty'a aake, place a vrite protect tab ovar 
tha notch on your DOS XL maatar diak, if it doaa not 
already hava ona. Thia protecta tha ‘antlre dlakatta 
from baing writtan to in any way. You ahould alao uaa 
writa protect taba to protect your program diaka from 
accldantal changa when you do not need to writa to them. 

At thia point, tha DOS XL manu of 13 commanda will ba 
diaplayad on tha acraen. Tha following prompt will 
appaar with tha curaor balow iti 
Enter your aelectlon. 

You typai D 

Thia ia tha command for Duplicata Diak. You will than 
ba aakedi 

Double danalty? 

If tha aiza of DOS.SYS indicatad in tha fila diractory 
waa 046 (aectora), than you bootad • aingle danalty 
dlakatta, ao 

You typai N CRETURN) 





‘•".ity dlakatta. than you bootad a ^bi. 

You ?»« V CRETURN) 

*£ a^ puc#t- disk) « 
Utility progra* will h. i a , CouBU danalty dl.kf 

naxt^proopt ^ Ä 

3ourc. diak (1.3.3,4) , 

vo^ir; you wl i u c s R ^- r ao. • : 

T <> tha prompt i 

Deatinatlon di.k {l.a. 3 ', 4 , f 

Tou typ«, l CfiETURM) 

I ^ ofor to^aection ?°of h thl tW ° dl * k drivel~"pi”~’7 

Tou will b. aakedi 

Format deatinatlon diak (Y/m)j 
« oat blank diakatt.. 

m.r t 0 rT r<,d to d?. f 2™ui: d * i., t h. y . r . 

s ~ Ät 

Point. ,o 3uat d tv^e,* h ° Uld • tl U »>• in driva 1 at thl. 
Ireturu) 

*** th. 9h DUPD S K h : t futy w°nr;. r dl * k * rlv . will ccaa on 
"•«ding »ourea diik ,pond ••ying. °“' 

* InÜ?t deatinatlon df 0 ? pt#d * 

And hit "ETURM when r«4 nt ° driv * » 








Th« DUPDSK Utility ha« r«ad a« Buch aa poaaibl« of th« 
lourct di^k into aenory. At thi« tima, reoovt your DOS 
XL »aatar diak fron drlv« l and ina.ft • blank diakatta. 
when thia ha« baan dona, 

You typ«| fftETURHj 

Tha progr&a will raapondi 

fornatting daatination dlfk 
and, aftar a whlla, 

Wrlting daatination diak 

”°?t ? £ th * th * total Information on a diakatta 1 i 

too larg« to hold in your Atari'a mamory at ona tim/ 

A7„ k *** C **! * or your 003 XL <»*•*• Tharafora. u6u 
will b« prcwptad to rapaatadly inaart your «ourca and 
daatination diak* (th. DOS XL »aatar Ind th"blink 
diakatta, raapactivaly) until tha duplication* la 

Sk^uiu} 1 ?:,^:: pr °“ pt ' »»t« th. 

„ Co Py •««« di«k again (Y/tj)? 

You typai 1 ( CRETURtq 

Th« DOS XL manu ylll than prompt| 

Hit KETURH for manu 
YOU typai fRSTURHj 

point, you hav« aucce.afully m«da a copy of your 

^h.“ a ’o? r K dUk - v Flr,t plac * * protact^ab 

°_ t | l * "otch on th« copy «o that it r ia nawar 
accidantly writtag to.. Labal tha di,k approprlataly and 
atora It ln a aafa plac« ao that you can uaa it if avar 
your »aatar diak fall, to vork proparly. f f 


tnt«rlc=:^ v , <r i””” 

--- - 5-?? kh * c,r trldg. 


‘At thia pr?- —■ IB __ j 

S^uct. 8 ^^^ * L ‘ ^ZOh'I, ta oc at Ö!hmc a C * rtrld 5« ko uaa 

_ • —* — * UM £ c 


,} If you n 
j! cartridcau 

*hd inaer- 
j diak ia ia 
J procaaa v 
I manu. 


“ v °u hav« nQ k , i *——— 

k^tn^off'you*** a £ r «*..d-airad f 

—- 11 . ““ PUc *' ÄS yo^VÄ ! 


10 «ntar tha _ , "* ~ . 

ae * B| »and in - - - , n, C *55 r * d 9“ you aiuat uaa 

tou typ., , s th « «S XL „a„ u . To uaa t£«\ c2LaE. rkrld S*" 

£ou will <11 

** “• foc 


you a r vau *£17*7 ——— 

r«f« r to aa- *.« * r “®* n 9 th« Atari ai«;Tr .---- 

conuoands v7r.rl n "Chl^ 4 ° f thi « »anufl ffr*!*^??' pl,a ** I 

diak. p or r J\* ch »ay b« u .ad f rom aASIp d ? ta11 * ° n th« j 

®MIC unaaar „“I ‘ ho ’* you alraad^ffif ff t0 ? CC ««« tha } 

«cc««s i- ... 4 n<S ?f Atari Dos 2 0 a Atari I 

im ld ««kical unS.r • not. that d?^k j 




















Section 3« THE DOS XL MENU 


luowi^g you “o* b * **** to whlU 

Computer* Power og th« Atari 

h«r* i^°r.u^ a r^°of th« di« P r,v i°u*ly ua«/Atari DOS. 
»*nu and th* Atl?i DOS^nanuff«r*ne*. b*tw*«£ th* DOS XL 

l> ^^fh^dl.^Vhanlva^ o*"“ " U * t b * ln 

Cartridge. Sinca w» you r * turn to MS froo a 

alow and cuiaberaom«** 1 * tha 5 thi * P roce *« wtg too 
■enu MAY b* kept ■re.iLt'^n that ^ h * D0S XL 
time*. Thi# doa. * * ln Be ®°ry) at all 

memory, but ^ ^ 

u«ing DOS XL uln, . c _J: nan . otI, ®t i t you ar« 
utiliz* th* memory taken 0 ^ 4 ^^ 9 *' If y °“ wiah to 
th* DOS XL command pr^a.Sor Y you u «« 

that memory. proceaaor, vhich do«a not ua« 

2) MEM.SAV - Atanl n ™ * 

nim ln whlch to .av^ u«r°^! th * u “ ° f * 

COS Function«. DOS xr . “ e “ory whil* acceaaing 
HEM.SAV iil«! 008 ^ nelth «* aupporta nor naada . 

aingle key y to C «c£e«^" com^nd° S XL .“ enu naada only a 
reguiras» a carriag. „STÄr 5.“^^ tt £? 


3.1 Entaring Command« 


a pp«*r o„' th. nt : c r :. d ; n , th - fou °-^ «•* of 

DOS XL MEUU varaion 3.30 
Copyright (c) 1983 oSS. Inc. 


Fil«a on Diak 
To Cartridg* 
Oopy File# 
Duplicat* Diak 
Eraa* File« 
Initializ« Diak 
Xtandad Command 


Protect File* 
ünprotact Fil«« 
Panama Fil« 

Sava Binary 
Doad Binary 
Oo to Addreaa 
Quit to DOS XL 


S5SU2? 003 XL “* nU lm vl.lbl. on th. acr«*n, you *r. 
Ent*r your #*l*ction. 
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you for ««rm r i i *-«»Ä4iv3 f th« mmmt 

command loada a utilii- information. Unlaaa th« 

Ff&sS 

*«lti*li c « Diak*), you M V ri h*" * “ Du P Uc *t* Diak'f 
® to tbort XZZ command^* “ ' 8 «TM 

a-orlb. .ach m.nu command i„ 
ordar. HOT th. ord.r in -hich 














3.2 C - 


c °py m*t 


CP äquivalent« COfy 

yOU '**'"'** m** batw..„ 

Th. -5*^ _?F 5° different fila. an tha aa.« diakatta 

. % ü .^ A ‘ 2?*i U " <u * *>' «>pjik °n£ 

d.alr. to trfnitlr *° ? noth »r« *f y°u 

diak.tta. to ’.'oth.r diT£!*Jr feh * * 11 ” oa * «in«!« 

"Dupüc«t» ouk^ÄVi^nvf* wiirparfö™ 

Operation »uch more rapid ly. f V parfo rm tha 

SoaÄ ‘IT c “ u «" d . -c* whan tha manu 

srt&i!f^^?Sas 

program. you v i£i d °*’ “ ot tlnä tha COPy.COM 

-«t.r dlJTa, UllowST ? t0 Ln '*^ r°^ 003 XL 

Copy Fiiea 

», Inaart HA3TER diak and hit RETURN 

“d y in."rt ;our h M3 P ^rr\ t * k ^°^ * n ^ i,,c in ailv ‘ 1 

kay. • y «aatar diak and preaa tha RETURN 

Tha aanu will than prompt« * 

Copy File. . 
fron (4l«i 

po s:- ,n: :i°“tfi.:"?rv i ä 

DiGEORGE, D2 iJUNK.LIS «tc 1 Copi#4 

to tr.n.far tha conKnt. of'th. m/5J2o?i of n W *"f 
to anothar diakatta, you ahouid l}„ 1 


j a“t‘c'?T th V^C^ 

i seä 

I 01 «}. ’ * ’ “ th * • ourc « dri ' r « numbar 


Tha COPy Utility will than prompt« 

To fila« w 

E« c^ii 4 ya 5*:Si - wa« th J h V M ti"*ti« «ll-P-c. In 

di.k.tt. to anoth.r «lt^ J tr ; n * f ? r ,U ” ^o« ona 
aoothar wlthout changing thalr na»«,. i n 
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thia caaa you may rafer to tha daatination fllaapec aa 
juat Dn«, vhara n ia tha daatination driva numbar (a.g., 
Di, Dl«, 02«), In tha abova exampla, if you vantad to 
copy PR0Q1 to a diffarent diakatta and you own only 1 
driva, you ahould typa "Dl«". 

You will than ba aakad« • 

Singla Driva? . 

ie you own only a aingla driva aa ln tha abova axampie, 
or if you ara parforming thia <»opy to anothar diakatta 
ln tha am driva, 

You typa« Y [RETURN] 


In any othar caaa, , ■* 

You typa« N [RETURN] 

Tha C0PY.COM Utility program will than ba loadad fron 
tha diakatta, and you will ba prompted» 

Inaart diak(a) to ba coplad 
and hit RETURN whan raady 

Remove your maater diak and inaart your aourca diak. If 
you own mora than ona driva and ara copying to a aacond 
driva. inaart your daatination diak into tha propar 
driva. 

You typa« [RETURN] 

Beffora aach fila ia coplad, you will ba aakad« 

Copy 

Dntfilename 
to Dn«filenarae? 

If you wiah to copy that particular fila, 

You typa« Y [RETURN] 

Otharwiaa, 

You typa« N [RETURN] 

If you chooaa not to copy a fila, a meaaage will ba 
printed to tha acraan varifying that tha fila waa not 
copiad. 

At thia point tha aourca fila will ba raad into memory. 
If you ara copying to anothar diak on tha aama driva, 
you will than ba prompted to inaart tha daatination diak 
aa tollowst . 

Inaart 'to' diak and hit RETURN 

If tha daatination fila alraady axiata, you will ba 
aakad« 

*To* fila alraady axiata 
OK to overvrite? 


i 





V 

If you wiah to replaca th« old fila with th* aourca 
fil«. , 

You typa» Y [RETURH] . 

Othe rwi mm t 

You typet H [RETURH] 


I If tha deatination fil* haa previoualy baen guarded I 
agalnat modiflcatlon by uaing tha DOS XL nanu I 
"Protect File*" command (i.a., tha fil* ia pracaded j 
by an aateriak in tha "File* on Diak" liating of tha I 
diak), tha COPY Utility program will not be abla to I 
overvrite that fila. The protection muat firat ba I 
removad uaing tha "Unprotect Pilat" command bafora i 
that fila may ba written to. j 


Tha OOPY Utility raada aa much aa poaaibla of tha aourca 
fila into memory at ona time. If tha aourca fila ia too 
larga to fit into memory and you ara copying on a aingla 
drive, you will agaln be promptedi . 

Inaert ’frora* dlak and hit RETURH 

Ra-inaart your aourca diak and Continua to carafully 
follow th* directiona of th* prompt* until tha antir* 
fila ia copied. 

• 

When a fila ha* baen completely copied, ^ a varification 
meaaaga will be printed on tha acrean.* Khan all filaa 
have bean copied, you will ba promptadi 
Hit RETURH for manu 

To return to tha Hat of manu command*, 

You typet [RETURH] 


Th* "Copy Fila*" command ahould not be uaad to copy I 
from aingla to double danaity diakattee if you own I 
only ona dlak drive. Inatead aea aaction ? for I 
Operation* involving multiple denaitiea. In | 
particular, aaction 7.3 diacuaalng aingla to double I 
denaity copiaa on a one drive ayatem. Sa* alao I 
aaction 6.16 and b* aura to read all of aaction 7. I 
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OCP eguivai.e n = z —avelentat DUPDSK 

OUPDBL 

ccontenta Q f . “5? * Uickl * «»• «nttr. 

tto copy QBtvwa. only on* or juat e fa^ h fli <ll *a* tt ** lt ¥ ou wl,h 
tto tnoth«r. ^ Mr /or “ tiU * tt0m on * ilakatu 

^air«ady cn on P r ****“ v * *°®* of th« fil«« 


, c T*rf "*••• "“ü«!,”»«" 

i! sss SS «=' 


Wou will «usüistt,, b . ,. k8d| 

Duc- .ia uplicata Dlak 

Douc-utoubla danaity? 

r:ou y ^,; cuÄ — d H , [^ R H f ? nMtt,d und * r - in ^' 

«öVi;r tE= r rc * u ? t t^ss u 

a»emory! U “: wU1 *>« read into 

Sourccccapurc* diak (1,2.3, 4 ) t 

Ä;-.“tSU“ —• 1 - 

YHou will t« promptedi 

Da.or^tw.etin.tion di||k (1 , 3#3j4 , , 

dcrin U l h irv2i^iryoCr / d«Un?M 0 dr i V ?* ° C *° u wl,h to ‘ 

Ytou typ.. dtiW ** 

doaatination Ii=soi=n*drlv* * drive other than 1 f or e 

Ycou type, n [RETURH] 
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«her« n thf numba? oC th« d*»lr«a ^«»tln»tloi> driva. 

You will b* aakadi 

Format d««tin*tion diak (Y/H)? 

Hoat blank dlakatte# ar« unforvattad. That ia, thay ar« 
not yet praparad to hold dlak fila*. ‘In ordap to copy 
Ille* or diakatt«* to blank diakattaa, ^hfy aiuat ftret 
b« Cormattad. Tharafor«, 

You typ«i Y [RETURH] 

At thl* polnt, th« DUPDS|C utlllty will aak you toi 
Inagrt aourca dlak into driva 1 
And hit RETURH whan raady 

IC you apacifiad a daatinatlon driva dlCferant {rot» th« 
aourca driva, you will ba prouptcdi 

Innert aourca diak into driv« 1 
Inaart daatinatlon diak into driv^ n 
And hit RETURH whan raady 

f 

Inaart th* propar aourca (and daatinatlon di*k« if ualng 

2 drivaa) into th«"propar driva, and 

You typai [RETURH3 . 

Tha light on th« front of your diak driva will poai on, 
and th« DUPOSIC utillty will raapond by yayingi 
Raading «ourc« diak 

IC th« daatinatlon driva ia tha aaag *a th« «ourc« 
driv«, you will b« promptadi 

' Inaart daatinatlon diak into driva n 
And hit RETURH whan raady 

At thia tim«, ramova your aourca diakatt^ Crew driva 1 
and inaart « blank diakatt«. Khan thia haa baan don«, 

You typai [RETURH] ... 

Th« progran will raapondi ' 

Foraatting daatinatlon diak 
and, aCtar a whila, 

Writing daatinatlon diak 

Hoat oC tha tlna, th« total Information on a diakatt« la 
too larg* to hold in your Atari*a maaory at on« tlna. 
Thia la th* caaa Cor your DOS XL diak. Thorafora, you 
will b« prompted to rapeatadly inaart your aourca and 
daatinatlon diaka until th« dupllcatlon ia conplata. 
Folio« thaaa prompt* caraCully until tha DUFOSK utlllty 
raapond*■ • - 

Copy «am« diak again (Y/H)2 

You typai M [RETURH] 
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At thia point, you will ba promptadi 
Hit RETURH Cor nanu 

To raturn to tha DOS XL manu, 

You typai [RETURH] 



3.4 I - Er«»« Fil«a 


CP aquivalanti ERAse 

Th« *Era»a File»* conunand allows you to dalat« on« or 
mor« Elle» Erora » disketta. Thi« conunand ahould b« uaed 
wlth car«, Eor «raaad Eil«« cannot «aally b« r«cov*r«d, 
if at all. 


I Xf you uaa th« "Erasa Fllea* command to attempt to I 
| «raa« a Eil« which ha» pravloualy been prot«ct»d I 

1 (1.«., tha Ella nemo la preceded by an aatariak ln t 
th« dlrectory listlng), you will b« glvan th« «rror I 
r measage "FILE PROTECTED*. IE you daalra to araia j 

I thia £11«, you must Eirat rcmova tho protection by I 
ualng th« "ünprotect Fllaa“ conunand. Bot« that I 

I protectlng Elle» 1» an «xceliant way oE guarding I 
agalnat accldantal eraaura. I 


To uaa thla conunand, aelect 'E' whan tha manu prompt« 
you Eor a command aelaction. Tha nanu will than prompti 
Er«»« File» 

Filespec to araaai 

You ahould reapond wlth tha nama oE tha Ella you wlah to 
•raaa. IE you wlah to eraaa a group oE Ellaa, you may 
uaa wlld-card charactera ln th« Eilaapac. Howavar, b« 
Vary aur« you know what you ara eraalng.* 

You will than b« aaked« . 

Ar« you aur«? 

IE you E«al tha Ellaapec you antarad waa correct, . 

You typai Y [RETURH] 

IE you wlah to abort’ tha *Eraa« Fllaa" conunand, 

You typai H [RETURH] 

IE you anawerad 'Y*. all Ellaa matchlng tha aalectad 
Ellaapec will be removed fron th« dlakatt«. Tha aenu 
will than prompti 

Hit RETURH Eor aanu 

To raturn to tha aanu oE cocuaanda, 

You typai [RETURM] 




3*5 F - Fllaa on Dlak 


CP äquivalent« DIRectory 

Th« "Fllaa on Dlak* command allows you to vi«w tha namaa 
of any or all Ella« on « dlakatt«. * 

To uaa thla conunand »Imply »alact *F* wh«n prcaiptad by 
tha aenu Eor a command aalactlon. Than Inaert th« 
d^alred dlakatt« Into <jn« oE your dlak drlvaa (or driva 
1 IE you hav« only ona driva). At that polnt, tha aanu 
will prompt! • 

Fllaa on dlak 
Fileapaci 

Th« Eilaapac r»qulred lnatructe OOS XL which Ellaa on 
tha dlak to look Eor and dUplay. Th« Eollowing tabl« 
givea aoma «xamplea oE Eilaapac* and tha correaponding 
Hat» oE Ellaa they displayi 


f ilaapaci 


Fllaa llatadi 


JUMK.SAV 


JOHH.77X 


Tha Ella havlng tha nama GEORGE. 
iE auch a Ella exiata. 

Th« Ella havlng th« primary nama 
JUMK and th« axtandar SAV, if 
such a Ella axiata. 

Any Ella not havlng an axtandar 
whoaa nama ia thra« charactara 
long whara th« Eirat two ara AB. 
Thi« Eilaapac matchas ABC, ABX, 
ABI, etc.' , 

Any Ella whoaa nama bagina wlth 
CAT. Th« Eilaapac matchaa CAT, 
CATCHER. CATTLE, «tc. 

Any Ella whoaa primary nama la 
JOHH and whoaa axtandar ia thra« 
charactara long anding ln X. 
Thi« matchaa JOHH.ABX, JOHH.XXX, 
atc. 

All Ellaa on th« dlakatt«. Thla 
Eilaapac may ba abbreviatad by 
Juat [RETURH], 


t 











Dls All fllef on th« dlqkatt« in 

djriwf l. 

D2« AH fil«f OR thf ln 

drivf 2 . 



Co to Addreaa 


CP äquivalent« RUH 


Thia command allowa you to paaa control of your Computer 
to a mach Ina language program alraady raaiding in your 
Atari Computer*« mamory. Thi* program ihould hav« 
prewioualy baan loaded into memory uaing th« DOS XL manu 
Load File command, or an äquivalent method. 

To ua« tha *Go to Addreaa“ command, typ« *0* when th« 
manu promt “Enter you aelaction,“ appeara. At that 
time, tha manu will prompt« 

* Co to Addreaa 
Addreaai 


You ahould reapond with tha hexadecimal addreaa of the 
location in memory you deaire to jump to. for example. 
if a machine language program reaides at location $5000 
Ithe dollar «ign indicatea hexadecimal), you vould 
reapond with “5000“. Not« that although the numbar ia a 
hexadecimal value, you ahould not praceda it with a 
dollar aign when you enter it. 


I Ba eure that the addreaa you enter ia correctj for, | 
I in general, if you paaa control to « location in 1 
memory which doea not contaln the deaired machine I 
I language program, control of your Computer will be I 
lost and the keyboard will “hang*:. In aom« caaea, I 
hitting th« SYSTEM RESET key on your Computer*« I 
keyboard will return control to you. Most of tha | 
I tima. however, you will be forced to turn off th« I 


At thia point, control will be paaaed to the machine 
language routlne located at the deaired addreaa. If 
that routine returna to the menu with a 6502 RTS 
inatruction, you will be aaked« 

Hit RETURN for menu 


return to the menu of commanda 
You type: [RETURN] 






3.7 X - Initializa Disk 


CP aquivalenti INIT 

Tha “Initializa Disk* command allowa you to foroat blank 
dlakettea ao that you »ay uaa them to atore program and 
data flies. If you wiah to creata a bootabla diaketta 
rather than Juat a data diaketta, you will normally want 
to duplicata your DOS XL maater diak. In thia caaa you 
ahould uaa tha “Duplicata Diak“ command rather than tha 
“Initializa Diak“ command. If you want to duplicata any 
of your diakattea uaing tha “Duplicata Diak" command, 
you do not need to formst them first uaing the 
“Initializa Diak“ command, for tha “Duplicata Diak“ 
Utility will perform the format Operation if you deaire. 


1 The “Initializa Disk* command writea antiraly new I 
I Information to the deslred diaketta, thua eraaing I 
I completely all flies whlch previoualy exiatad thera. I 
I Carefully aelact the diaketta to initializa to avoid I 
I accidantly deatroying your program diaka. ’ i 


To uae thia command, aelect 'I' when prompted for a 
command aelection. At that point, DOS XL will check for 
tha presenca of the IN1T.COM utllity on tha diaketta in 
drive 1. If It ia not there, you will ba promptedi 
Initializa Diak 

Ineart MASTER diak and hit RETURN 

after whlch you ahould inaert your DOS XL master diak 
and hit the RETURN key. 

Then tha INIT utllity program will ba loadad lnto memory 
and you will ba präsent with the 4 optiona of tha INIT 
program. They arai 

1. Format diak only 

2. Format diak and writa DOS.SYS 

3. Writa DOS.SYS only 

4. Ezit to DOS XL 


I CAUTIONi The I (INIT) Option may normally ba ueed I 
I ONLY to Initializa diakettea of tha sama denaity aa I 
I tha master diaketta you hava booted. Saa aactlon 7 I 
I of thia manual for Information on othar optiona. I 


! Normally, you ahould uaa the *Duplicatä"~DlIk“'7 
I command to copy your DOS XL maater to craata a anare I 

^ed^Uh in’ C 'alr° W d Vaf ; ° Ptl ° n 2 (ind ° ption 3 “ han I 
“Initializ! n? y fo ™*“ed. diaketta) of the| 

toütaMe dt.k? “«* to * I 


I Do NOT, howev.r, uae aithar Option 2 or 3 if you 1 
I hava booted the syatera with tha fila “DOSXL sy-i* I 

th r :“ n in:tru:ti tiv# **• " ! 

[ a*tanded*»amory°DOS 8 ** *» I 


I Usln * an axtandad memory DOS f 

configuration, we auggaat that you boot vour 

thereof) b 4 ! ter d ! akatt# * direct dupllcate 

I thereof) bafora uaing Option 2 or 3 of thia command. 

I Comrnent« Aftar uaing Option 2 to craata a bootabla 

dlak'if it^f tö S h S ^ ould b * Copied onto that I 

u,ad with * n OSS SuperCartridga. | 

If you wiah to craate a bootabla diak. 

You typet 2 [RETURN] 

If you wiah to creata juat a data diak. 

You typet 1 [RETURN] 

You will ba aakedt 

Drive (1,2,3,4), 

You ahould reepond with the deairad drive mietbar (alwava 
1. if you hava only ona drive). ' laiwaya 

You will ba aakedt 

Option n drive n - Ara you aura (Y/N)7 

If your ar# happy with your entriea so far, 

You typet Y [RETURN] 

Otherwise, 

You typet N [RETURN] 

«.cXSd.^ou will i' Pm Zi lL ' d CO ““ and b. 

optiona. »gain ba praaanted with tha 4 

atepa? «P-« tha abov. 

You typet 4 [RETURN] 

Xou will ba raturned to tha DOS XL stenu. 
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3.8 L - Load Binary 


CP äquivalenti LOAd 

The “Load Binary* command allowa you to read a binary 
flie frora dlek Into the memory of your Atari Computer. 
ThU command can be uaed to load binary Object of 
aasambly language program*, or binary data to b* u**d by 
»uch program». The flla you wlah to load ahould bava 
pravloualy been wrltten to dl*k ualng tha DOS XL manu 
•■Save File“ command, pr an äquivalent method, 

| Do NOT uae thla coromand to load Atari BASIC or BASIC I 
| XL prograraa Into memory. Inatead, juat uaa the LOAD I 
| command frora tha BASIC cartrldga (l.e.. after you 
j have baan glven the “READY“ prompt). See aectfon 
I 4.6 of thla manual for more Information. I 


To uae the “Load Binary" coromand, type *L' when prompted 
to enter youp coromand aelectlon. the manu *wlll then 
prompti . ■ , . 

Load Binary 
Fllename, 

You ahould reapond wlth tha name of the pravloualy aaved 
file you wlah to load. For example, If you wiah to load 
Into memory the flle "FILEl.OBJ“ on drlve you ahould 
type “DiFILEl.OBJ“. 

At thla polnt, DOS XL will acceaa the dlek to read ln 
tha binary flla. You will then be aekedi 
Hit RETURN for raenu 

To return to the DOS XL menu of command*, 

You type! [RETURN] 
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3.9 p - Protect Fllea 


CP äquivalent! PROtect 

y ° U wiU hava craatad «i.a on your dlek. 
Yhir« ^ knOW yOU wiU hardl X «var need to aiodlfy. 

lorrl l ^ y t0 i1 Uar ? thaaa •« you need not 

contLtt^ Vh* CC in* ntly dalatin 9 or oodlfylng thäir 
, 1.. Protect Filae* command allowe you to 

The« ffl«* fil? eraeure. or modlfl«tlon. 

dlraetnr« *T 1U . th-n ba prec« d «d by an aatarlak ln a 
f*5 Ct ? Y Uatin 9 whan you uae the “FUea on Dlek* 

protection irr i U A *± m f “ tur * y° u d **lr» to remova tha 

iff or ?* d y thi * command * y°“ »houid u*. th. 
Unprotact Fllea* command. 

3L U for thi * C °“ d * * olect **’ the menu prompt, 

you for % b °“~£ d p «lectlon. Th. menu will then prompt, 

Flleapac to protecti 

You ahould reapond wlth the name of tha fll. you wlah to 
Protect. Xf you wlah to prot.ct a group offilea? voS 
»ay U.e wlld-card characteri ln th. fll.ap.c. ' Y 

wlli t h3 a r,n P ? ln . j th ° di “ k wl11 b * acc «**ed and the fllea 
•will be protected. The menu will then prompt! 

Hit RETURN for menu 

To raturn to th* menu of commanda, 

YOU type, [RETURN] 



I 











•# 


3.10 Q - Quit to OOS XL 


CP äquivalenti nona 

Tha *Quit to DOS XL* command 1« uaed to paaa control 
frora tha DOS XL manu to tha DOS XL command proceaaor. 
Although almost all tha functions you need frora DOS may 
be accompliahed from tha DOS XL manu, certaln commands 
and featurea aca acceasible only frora tha command 
proceaaor mode. 

To uaa thla command, type '0* whan prompted by tha manu 
to enter a command aelection. At that point, control 
will ba transfered to the command proceaaor mode. 

Whenever you enter the DOS XL command proceaaor, tha 
following measage will appear on the acreem 

DOS XL - Atari Version 2.30 
Copyright (c) 1983 OSS, Inc. 

Dli * 

The *D1i* which appeara to tha left of the curaor ia the 
prompt for the command mode. In thia mode you are 
expected to type ln a complete command line rather than 
simply a command selection. For example, to load tha 
DUPDSK.COM utility (for dupllcating aingle denaity 
diskattes), the DOS XL command line ia "DUPDSK*, rather 
than a single character aa in the menu mode. 

There are tvro major types of commands which you can uoe 
when the Dir prompt appeara, Intrinslc Commands and 
Extrinsic Commands. Aa a user, the only real difference 
between theae two types is that • a master dlsk (or, 
sometimes, a subset thereof) must be ln place ln drive l 
in order to use an extrinsic command. Section 5 of this 
manuai detaila the Intrinaic Commands. Section 6 
describea tha usual Extrinsic Commands. 

It is also posalble to write your own commands to be 
used from the DOS XL command proceaaor or the "Xtended 
Command“ menu function. For mora Information on thia 
capability, refer to aection 10 of thia manuai. 

Certain featurea of DOS XL such aa batch proceasing are 
available only from the DOS XL command proceaaor. For 
Information on batch Processing and axecuta files, 
please refer to aection 9 of this manuai. 
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In ordar to raturn to tha DOS XL manu fr«, 
proceaaor, Inaart your DOS XL VaI Z ?" th * com »*nd 

drive (or drlv, l/lf you * l * k lnt0 V our dlak 

Than. frora tha DU prompt th *° ° n * 

You *«»•* «EWU Cbeturm] 

Tha DOS XL -anu program will b. lo.d.d and axacutad. 









3.11 R - Ranama fila 


CP äquivalent« RENamg 

The “Renama flla" coromand may ba uaad to Change tha flla 
name asaociated wlth a Elle of Information. Th le 
conunand doaq not alter or delete any Information 
contained in tha fila, Rathar, tha fllf will only show 
up with a different nana in tha diractory liatlng whan 
ualng tha "Filef on Disk* conunand. 


I lf you attampt to renama a fila which haa been 
protected against modification (l.e., tha fila nana 
I ia pracadad by an aateriak in tha diractory 
I iiating},.you will be glven tha error messaga “FILE 
I PROTECTED“. lf you deaire to renama thla fila, you 
I must first ramove tha protection by ualng tha POS XL 
| menu conunand, "Unprotect Flies*. 


To uaa tha “Renama Fila“ command,. aelact "R* whan tha 
menu prompt, “Enter your aelectlon.“ appeara. Yoq will 
then ba askedt 

Renama fila 
Old naraat 

You ahould raapond wlth tha current name of tha fila 
whose name you wlah to change. For exampla, if you want 
to changa tha name of tha fila “DiGEORGE“ to “piPROGl“, 
you ahould type “DiGEORGE“. 

The manu will then raapond, 

New pamai* 

At thia point you ahould type tha new namt you wiah tha 
fila to have. In tha abova exampla, you ahould type 
“PROGi* at thia time. Notice that you must NOT uaa a 
device apecifiar (l.e., Pt, D2<, etc.) in tha naw name; 
you ahould type just “PROGI“, not "DiPROGl“, 

You will then ba ask?d, 

Ara you eure? ■ 

If you are aatiafled that you hava entered both fila 
naraea corractly, 

You type« Y [RETURN] 

If inatead you wlah to abort tha renama Operation, 

You typai N [RETURN] 



“nIm?d* n, T* d WUh ’*'• *h* designatad 
You C t^a? t0 RETURN] CO “ mand ** 


fila will 


b« 
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3.12 S - Sav« Binary 


CP äquivalent, SAV« 

Th« "Sav« Binary' command allow« you to writ« a portion 
of your Atari Computer*« memory to a diak fite. thia 
command can be uted to «ave to diak binary objact of 
aaaembly languag« program«, or binary data to b« uaad by 
auch programa. ' 


I Do NOT u«e thia command to sav« Atari BASIC or BASIC I 
I XL programa frora memory. Inatead, Juat uaa th« SAVE I 
command from the BASIC cartrldg« (i.a., «ftar you I 
have baen given the "READY“ prompt). Sa« aaction I 
I 4.12 of thia manual for more Information. | 


I If you attampt to aave binary data to a fil« which f 
haa been protected agalnat modification (i.a., th« I 
file name ia preceded by an aateriak in the I 
directory llating), you will be given th« error I 
meaaage "FILE PROTECTED“. If you deslr« to rename | 
thia file, you muat firat remove the protection by ! 

I using the DOS XL menu command, "Unprotact Filea*. j 


To uae the 'Save Binary* command, typ« *S* when prompted 
to enter your command «election. th« manu will then 
prompti ^ 

Save Binary 
Filenamei 


You ahould reapond with the name you vlah the aaved fil« 
to have. For erample, if you vlah to writ« memory from 
locationa $4033 to $4133 (the dollar aigne indicat« 
hexadecimai addreaaea) to th« fil« "FILE1.0BJ" on drlv« 
1, you ahould typ« "DiFILEl.OBJ". 


I It ia recommended that binary object fil« name« have I 

innt!* tena JS n r°2r* or " COM ‘‘ In th. former I 
caae, OBJ would indicat« that th« file vai an I 

aaaembly language OBJect file for a program or data. I 
The aecond extenaian. "COM"- ..v.. ..._ i 


indicate« that the j 


program i« « ayatera utllity program which wa« either t 
included with your DOS XL raaater diak or «ritten by | 
I you or «nothar uaer. r 


At thia point you will b« promptadi 
Starting addraaai 


firat addr...’ you wi.h tö «,7. ! v,lu * ot th. 

axampl« th« «tarting addr««« waT «4000*''’ 10 th * * bov * 

typ« *4000“. Uo t. § ° «hould 

hexadecimai, you ahould • lbh O“9»» th« v«lu« ^ 

dollar «ign. 0t P r,c *d* th* numbar with a 

Th« aianu will th«n prompt, 

Ending addrea«, 

“ — - 

T°u typ«, t0 0i coolo *nd«. 
















3.13 T - To Cartridge 


CP äquivalent« CARtridge 


Thi* command »1low* you to enter a cartrldg*. if ona ha« 
been ineerted. - •'' • 


IT you ara ueing th« Atari BASIC cartridga, plaaee 
refer to chaptar 4 of thia mapual Tor Information on 
command« which may be uaed frora BASIC to acceee the 

t0 A th0 f® °f y° U al J ead y familiär vlth Atari 
BASIC undar Atari DOS 2.0«, plaaee not that diak 
accaaa 1« identical undar DOS XL. 


To uae thi« command, «elect *T' whan prorapted by tha 
menu Tor a comroand aelection. At that klm«. you will 
th * cartrld 9 e and *« e tha Tamillar READY prompt of 
BASIC, or tha prompt Tor tha particular cartridga you 
«re uaing. If no Cartridge waa inaartad, tha arror 
aiesaaga BO CARTRIDGE will b« dlaplayad. 


"T° Car tridge* command ia uaed «Ttar any of 
tha following command« ara aelectedi ’ 

Copy Eile« 

Duplicate Diskette * 

InitialIze Dlakatta 
Xtanded Command 
Load Binary 

a cold*tart will be parformed by tha cartridga, thu« 
eraalng any program which was in memory. Tharefora 
IT you wlsh to go to the manu to axacute any of 
these commanda. ramaraber to firat writa any program 
you ara working on to disk. Thi« i« accompii.hed ln 
Atari BASIC or OSS BASIC XL by Uaing th« SAVE 
command in th* BASIC cartridga. 3 E 


3.14 U - Unprotect Files 


CP äquivalent« UNProtect 

The “Unprotect Filea* command allowa Tilaa to be 
renamed, araaed, or modlfied, thus removing protection 
applied by the “Protect Filea’ command. These filea 
will no longer then be preceded by an «atarlsk In a 
directory listing when you usa th« “Flies on Diak* 
command. 

To usa thia command, select 'U* when th* menu prompt* 
you Tor a command aelection. Th« menu will than prompt« 
Unprotect Flies 
Filespec to unprotect« 

You shouid respond with the name of the TU* you wiah to 
unprotect. If you wlah to unprotect a group of filea, 
you may uae wlld-card character* in th« Tileapec. 

At thia polnt' the disk will be accessed and the filea 
will be unprotected. Tha menu will then prompt« 

Hit RETURN Tor menu 

To return to the menu of commanda, 

You type« [RETURN] 










3.15 X - Xtended Command 


CP äquivalenti none 

Thia command may be uaed to pass a command line to the 
DOS XL command proceaaor. Although almoat all the 
functlona you need from DOS may be accompliahed frora the 
DOS XL menu, certaln commanda and featurea are 
acceaalble only frora the command proceaaor mode. The 
"Xtended Command" function of the DOS XL menu may be 
uaed to acceaa from the menu thoaa commanda available 
only frora the command proceaaor. Pleaao refer to 
aectiona 5 and 6 for Information about the commanda and 
featurea of the DOS XL command proceaaor. 

To uae the "Xtended Command“ function, aalect ’X* when 
prompted by the menu "Enter your aelection.*, At that 
time, the menu will prompt! 

Xtended Command 
Commandi 

You ahould reapond with the DOS XL command you wiah to 
have executed. For axample, if you wiah to uae the 
"RS232* command, you ahould type "BS232". 


I Many of the DOS ' XL commanda acceaalble by the I 
i "Xtended Command" function perform their operationa ! 
I by loading Utility programs on the DOS XL matter I 
I diak. Xf you wiah to uae a command which employe a I 
I utility prograra (any "extrlnaic“ command, aee thia I 
j manual'a aectlon 6), you ahould inaura that your I 
I DOS XL maater diak la firat inaerted lnto drive l. I 


At thia time,, the dealred command will ba paaaed to the 
DOS XL command proceaaor and executed. When that ie 
finiahed, you will be promptedi 
Hit RETURN for menu 

To return to the DOS XL menu of ccramanda, 

You type» CRETURN] 



Sectlor. 4, Atari BASIC and 0) 


-"(af^e^^L^f^LL 0 ™/ 0 - 033 r«t.r Dlaketta, you 
«ENU Of availabl, Option^ . pr ** anto< l «ith* a 

ln «ection 3.13 V c j «-«mH 0 ?* * n ••cfclon 2.5 und aq.j. 
command. If b^ted ßOs'« I , ( ‘ T ° ««tridgiSj 

Atari BASIC cartriige in place^or 7j th yOUr BASIC XL oc 
XL Computer with BASIC bull#- tf ** you hAV# Atari 
the -T- key and yc» U } nJ * you almply 

If you do not racelve a R£ADY C * iW * BASIC ‘« READY prompt 
Perhap, you forgot to inafrt^ y Prompt aft.r preeeing -?"* 
you held down Ih. 9# f ° r P*^ 

££.° c 7£Z; , l>;LZi 

prcauffl. thit *yo. 3 . r ^ h * n lr r. e ?* thl * " ctiür ‘. w« ,|]1 
time the BEAOY pro-Dt app^“* 0 * 310 ° f BASIC XL - Any 

Canarall jira P ; '> typing ‘th^ BASI^**“™ t0 th * 003 
Ceneraily, y ou m4v BXSIC command. DOS. 

•ny program you ma!- h v l„ .l t0 BASIC «ithout lo.i ng 

*. * T ' -«»» opilSiT* t a9al " ealectinf 

cautionary not. in .ection 3.13. * * Ur * and r »* d tha 


| I,r y°u have ch'.en * 

I Proceaaor mode ("Cp") th * D0S XL command | 

ST™ i 

I in.tead of the m.nu. Y 111 b * r «turned to CP | 

I 


I NOTE that ueing ^ from 

{ ^°T™ and P roc «»*or—CP—of*Dos n xL{ thU !I choo «in9 tha 
I £ AR oommand frc« cp win D qa i n L * And thon u * ln 9 the 
»paco a. corapar.dt2 OVAr J ‘ 00<> »***•• 

Thia i« becauee 3A5IC ie then «M 9 “i"“ °Ptlon *T*. 
| »pace formerly OC cudI.h k" allowci i to uae all the 
«ection 8 for infoSir?! Y tha ' MENU - »*• .1.! 
I procea«. tion on 'the DOS XL boot 


c^:„ d i l ^ n 9 tl *;;;i°"' wh d«. c rib; the mo.t common BASIC 
not« that -v,.„«crect rile* on th« Hi.it> 
b»ing th» BASIC XL ör Atarf'n'.cr* ah ould be iaaued while 
command. ahould f BA3IC That ia. th..^ 

prompt or uaed wit- a ‘n * i”v»«di*tely after tha RExnv 
program. Wlt ' 4 number wifhin ^our £££ 


Th. command. , r . P r...„ t .d ln , Xphabetlcal 
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4.1 CLOSE 


command« CLOSE 

purpoae« Thia command diaaaaociataa th« flla 

number (channel) and fil« which war« 
aaaociatad by a previoua OPEN 
§ tat«ment. 

u ‘ ar ?* BASIC XL and Rtarl BASIC uaara 

uaag« Cfosp ffn 

argumant» fn - fil« numbar 1-7 

examplaa< CLOSE fl 

CLOSE fOUTFILE 

deacriptionJ 

After CLOSEing a fila number, the uaar may no longer 

P Üf f ? r ? 1/0 yia P BINT « INPUT, etc.J on’the fila. 

which had baan aaaociatad with that channel. 

NOTE« a fila OPENed for any form of outnut (modea 8 9 

* h ? Ul ? ALWAYS bo cloaad tha diakette 

contalnlng it ia ramoved or changed. Tha moat common 
cauaa of Cfaahed At,a r * Diakattaa ia failure to ob.arva 
cnis rulft• 

KOTE« Atari BASIC doea HOT conaider it an arror to 
« han 2* 1 th »t i» not OPEN, ao It ia oftan good 
foirowingi° #nd * P ro ? r * B ««gment by «line auch ai tha 

999 fOR |«x TO 7 i CLOSE fl « HEXT I 

NOTE« both tha END and RUN atatementa cloae «XX filea 
(excapt fit« | 0 , tha keyboard/acraan). and can ba uaad 
to advantaga for thia purpoaa whan dealrad. 
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4.2 ENTER 


conunand t ENTER 

purpoae« Thia command *i« uaad to ratriava a 

BASIC program that haa baan LISTad to 
tha diak. 

BASIC XL and Atari BASIC uaara 
uaa 9<*« ENTER fXXaapec 

argumant« fileapac - tha nun« of tha fil« you ara 

going to ENTER. 

axampleas ENTER *D«PROGRl.LIS" 

ENTER OVERLAVFILES 

deacription« 

The ENTER command ia uaad to retrieve a BASIC program 
that haa been LISTad to the diak. Aa the program ia 
being ENTERed into BASIC*« uaar area, each Une will be 
checked for proper ayntax and converted into tha 
internal (tokenized) form uaed by BASIC. 

If a ayntax arror ia encountered, tha offending line 
will be liated with the auapected arror Xocation in 
invcrae Video. 

NOTE« Tha line with the error will, nevartheleaa, be 
placed in program memory. In auch a caae. your program 
muet be corrected befora you can RUN it. 

CAUTION« ENTER doea NOT clear the uaer memory apace. 
Therefore, if you wiah to ENTER a new program, uae NEW 
flrat. (Actually, thia can be a handy featura when you 
wiah to merge two program« together.) 

EXAMPLE 

10 PRINT ’THIS IS PROGRAM 1* 

30 PRINT “AND NOW FINISHING* 

LIST “DiPROGl“ 

NEW 

10 PRINT *WE ZAPPED THE OTHER LINE 10* 

20 PRINT "AND NOW PROGRAM 2" 

LIST *D« PR0G2" 


(continued on next page) 







4.3 GET 


(aection 4.3, axample, contlnued) 

NEW 

ENTER “DiPROG1“ 

LIST 

[and the Computer will LIST the followingt 
10 PRINT "THIS IS PROGRAM l“ 

30 PRINT “AND NOW FINISHING* ] 

ENTER “DiPROG2" Cdo NOT type NEW] 

RUN 

[and the Computer will respond withi 
WE ZAPPED THE OTHER LINE 10 
AND NOW PROGRAM 2 
AND NOW FINISHING ] 


Notice how the two programa have been neatly merged 
together and how line 10 from program 2 haa replaced 
line 10 frora program 1. Reroemberi like numbered lines 
frora an ENTERed program replace linea in memory, but 
otherwiae the program in memory (if any) ia not changed. 


— 45 — 



command■ 


GET 


purposei Thia atatemant will ratrieve a alngla 

byte oC data fron * apaclfied diak 
fila. 


uaarai 
uaagei 
argumentai 

axamplest 

deacriptloni 


BASIC XL and Atari BASIC uaara 

GET Ifn,avar 

fn - fila number 1-7 
avar - any numeric variable 

GET II,BYTE 
GET I INFILE,VALUE 


The GET atatemant ia uaed to ratrieve a alngla byte of 
data from a diak fila that haa baan pravioualy OPENed 
uslng the aama fila number. * 


NOTEi The data that you are GETting from the diak fila 
general ly ahould have been pravioualy writtan to tha 
apeclfied fila uaing the PUT atatemant. 


EXAMPLEt 

10 OPEN 11,0,0,“DiTEST* i REM CREATE A TEST FILE 
20 FOR I - 0 TO 2S5 I PUT II,I iNEXT I 
30 CLOSE II i REM WE CREATED IT 
40 OPEN II.4.0,“DiTEST* I REH NOW CHECK IT OUT 
50 FOR I - 0 TO 255 i GET 11,X | REM CHECK EACH 
«0 If X <> I THEN PRINT “BAD DISK DATA“,I,X 
70 NEXT I 

00 END t REM END CLOSES ALL FILES 


J NOTEi BASIC XL uaera may apecify Channel saro (GET I 
I 10). Atari BASIC uaers are limited to fila number* I 
I l through 7. | 














4.4 INPUT 


commandi INPUT 

nurooMi Th la command la uaed to raqueat data 

purpo» froo ^ ha »peci f lad (11* pumbar (or 

Jseyboard). 

uaera< BASIC XL and Atari BASIC uaera 

u , ag «, INPUT { f fr». 1 var (,var...J 

argumenta» tn - (Ue number i-7 

* var - «ither num«rlc pr strin^ 

axamplea» INPUT 13 f NftME? 

INPUf »INFILE, VALUE1,VALUE2 

descrlption» 

Hhen th« INPUT atateroent ia uaed without ehe fn Option, 
data will ba raquaated from the keyboard. You will 
notice a -7- appearln? on the acrean P^pting vou for 
the keyboard input. Sae your BASIC XL or Atari BASIC 
Reference Manual for roore detalla. 

When the fll« number (»fn) argument l« uaad, data will 
come in th. form of ATASCII Una. fror the file that 
haa been previoualy .uccee.fully OPENedu.Ing the aama 
file number. Otherwise, the action of INPUT i • 
virtuaily identlcal to the action when INPUTlng data 
from the keyboard. That la, a atrlng input la 
terminated by in ATASCII RETURN character and a numerlc 
input by eithar tha RETURN or a coraroa wl-.hif» a llne. 


EXAMPLE PROGRAM: TUDI1 _ 

10 DIM LINE?(103) I REM a atrlng for INPUT 
20 OPEN 11,8.0,“DiTEST" i REM craata test file. 
30 FOR I-i TO 18 i PRINT II» "RECORD *“ 1 I 
40 NEXT. I i REM we wrote 10-lir.ea to the file 
50 CLOSE »l » REM close the filt OiTEST 
60 OPEN »1,4,0,“DiTEST" i REM ready to read lt 
70 INPUT II,LINE? I REM get a Una from fii« 

00 PRINT LINE? » REM and »ho« lt on acraen 
90 GOTO 70 « REM and go get another llne 
Note that thla program will STOP at line 60 with 
an error (number 136), indicating it haa reached 
the end of the file. You could uae TRAP to good 
effect hare (aee your reference manuel). 
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line * t^at i. UT lQ * titeraent «««ot (g.„.r,l, vl 

you PHIOT a Uni to°th kh ^, 127 nlLal^ * 

to input, u u khat -*u° iiK?- « 

Une 127 character. th * ***• of th. 
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4.5 LIST 


command« LIST 

purposei Thia command will LIST tha prograra 

-currently in memory to the acrean (or 
‘to tha file apecified). 

uaerst BASIC XL and Atari BASIC uaera 

uaagei LIST [fileapec] 

LIST [fileapec,] linenol [,llneno2] 

argumenta■ fileapec — the name of tha flla you ara 

going to LIST to tha diak, 
linenol - beginnlng line numbar 
linenol - ending line numbar 

axampleai LIST "D2«PROG.LIS" 

LIST FILE?, 1000, 2000 

deacription 

The LIST command is probably One of the moat commonly 
used commanda in BASIC. Moat people know that the LIST 
command, when given all by itaelf, will LIST thelr 
program to the acreen. Even when beginnlng and anding 
line numbera are given the reaulta ara predlctable. , 

Now, with DOS XL, the LIST command can do aven more. 
When uaed with a fileapec, the LIST command will LIST 
your program to the diak instead of the acreen. The 
contenta of thia file will eontain text charactera and 
can take up a large amount of diak apace lf you have a 
large program. 

If you uae the Option where two line numbera ara given, 
then only the lines fr cm linenol to lineno2 (incluaive) 
will be LISTed to the fileapec. 

If you uae the Option where only ona line numbar ia 
given. than OSXY that line will be LISTed to the 
fileapec. 

NOTE» The ability to LIST a ränge of linea to tha diak 
providea a convenient method of ooving a aubroutina 
(for exarople) to another program. 

See also Section 4.2 on the ENTER command. 
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4:6 LOAD 


command i LOAD 

purpoaa« Thia command will gat a prograa that 

haa been SAVEd to tha diak and put it 
in BASIC‘a memory. 

“«•*■»« BASIC XL and Atari BA$IC uaera 

uaagei LOAD filespec 

argumenta» fileapec - The name of tha file you 

wieh to LOAD. 

axampleai LOAD ‘DiGAME.SAV* 

LOAD FILE? 

deacriptioni 

LOAD is used ln conjunctlon with the BASIC SAVE 
command. Only programs which have been pravioualy 
SAVEd to .diak may be LOADad. No ayntax chacklng will 
be dono aa your program ia belng LOADad, bacauae tha 
program ia already in internal formet. 

Generally, if you wiah to keep a program on tha diak, 
you SAVE it. Then, later, whan you wiah to look at it, 
modify it. or RUN it, you can LOAD it. BASIC doea not 
remember the name that you use whan you LOAD a program, 
so you can SAVE it again eithor undar the aame name (in 
which caee the original Version is lost) or under 
another name. 

Also, aee the RUN command for an altarnative method of 
LOADing a program which wj.ll simply be RUH and not 
modified. 

EXAHPLEi 

10 PRINT “THIS IS PROGRAM 1* 

SAVE *D«PROGl" 

10 PRINT *THIS IS PROGRAM 2* 

SAVE *D«PR0G2“ 

LOAD "DiPROGl" 

LIST 

[and tha Computer will Hat the followtngi 
10 PRINT “THIS IS PROGRAM 1" ] 

RUN “D.PR0G2" 

[and tha Computer will respond with« 

THIS IS PRÖCRAH 2 ] 
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4.7 note 


command« MOTE 

-ui, command determlnas the currant 
pucpo.a, philicat^i.k location of an OPEN fll* 

for later us. with th- POINT coausand. 

u ,. r ,, pASICXL and Atari BASIC usars 

uaaga, BOTE ffn. avarl. avarJ 

- _ fii« number fro« 1 to 7 

argumenta« _ | variab la to racalva the 

* currant aactor nurober 

avar2 - a variable to racalva tha 
byte offsett wlthln tha 
currant aactor 

examples« «OTE »l. SECTOR. BYTE 

axampicsi fIMFILE, 6. B 

descrlptlon« 

Thls cororoand generally requlra. « n 

r* 

" v “'is.r ?:,ir :ü n atr.Ä 

iS irk & *s"«*4«*siacs= 

and updatlng a flla by atartlng only at Ita baglnnlng. 

However. thank. to BOTE and POINT and tb. th.t tha 

forward Unk Includ«. a tllm nu» b »* SIS random 
exper lenced programroer roay create «^ 00 . balnq 

accese Index into elther an exlstlng fU« or on « bolng 
bullt. 

BOTE alroply notea tha current dlak aactor *"?, 

offaet wlthln that sector for any tnto 

flla. It placas tha sector and byta v»lu.. into 
variable. suppllad by the programroer. It l« tha 
proqraroroer's responslblllty to retaln and reroerober tha 
BOTEd values untll needed by the POINT Statement. 

The followlng axarople la not exhaustlve. but It doe. 
qive at least a Start on understandlng tha 
Implementation of random access flies under Version 2 of 
DOS XL or Atari OOS. ^ 




100 REH part 1« bulld a flla on dlak 
110 DIM LINESU50) , REM an arbltrary slta 
120 DIH SECTOR(100).BYTE(100J , REH ditto 
130 OPEN 11,8,0,*0«TESTFILE* 1 REH a new flla 
140 FOR l-l TO 100 

150 PRIHT "GIVE HE LIME *»I» 1 INPUT LIMES 

160 IF LEN(LINE?)-0 THEM 200 

170 BOTE II,SECTOR,BYTE 

180 SECTOR{I)«SECTOR 1 BYTE(I)-BYTE 

190 PRINT I1|LINES 1 NEXT I 

200 REH done craatlng tha flla 
210 CLOSE II 

220 MAXREC- 1-1 1 REH raally,. .check It out 

250 REH part 2t accaaalng tha flla 

260 OPEN 11,12,0, “DiTESTPILE* » REH flla wa made 

300 REH tha roaln loop 

310 PRINT "GIVE ME A NUMBER FROH 1 TO "tMAXREC 
320 PRINT “ (OR 0 TO QUIT) *| 

330 INPUT RECORD 

340 IF RECORD-0 THEN END 

350 SECTOR »SECTOR (RECORD } » BYTE-3YTE( RECORD) 

360 POINT II, SECTOR, BYTE 

370 INPUT II. LINES 

380 PRINT "LINE *» RECORD» *—‘»LINES 

390 GOTO 300 

If you type ln and run thls program, te awara of tha 
followlng« When the prograro asks for a ilr.e, you may hlt 
just RETURN and tha entry phaae of tha prograro will 
tcrminate. When tha program asks for a racord number, 
no check Is made to aaa If tha nurober you glva Is a 
legal ona (l.a., fron« 1 to MAXREC). 

If you have dlfflculty followlng thls axampla prograro, 
wa would suggaat Ignorlng the subjact of random accasa 
for now. Not all programs and programmers have 
need of such flies, so lt may not be advisabls' to spand 
too rouch tlma on thls subjact. 

If you ara a programroer exparlenced on nachlnea whara 
random accasa via byta relative Position ls poaalble, 
you may want to conalder OS/A+ Version 4, vhlch ls OSS's 
DOS for Atari Computers and double density (or largar) 
dlsk drlves. Flla posltlonlng under Version 4 ls aa 
simple as specifylng a 24-blt byta number whlch ls tha 
Offset fron» the beglnnlng of the flla. Version 4 ls NOT 
recommended for beginners and/or for thosa who naed 
compatlblllty with Atari DOS. 


—52 






4.8 OPEM 


commandi OPEN . 

purpoae« Thia command prepare« a fil« for acc««« 

and aaaigna it a flla nurebar. 

uaera« BASIC XL and Atari Baale uaara 

uaaga« OPEN t fn, aexpl. aexp2, fileapec 

argumentai fn - fil« number 1-T 

aexpl — I/O mode 
4 - input 

6 - directory acceaa 

8 - output 

9 - append 

12 - input/output 

aex P 2 - device dependent value 

(uaually ß) < 

fileapec - a proper OS/A+ filenam« 

examplea« OPEH #1,8,0,“D«NEWFILE* 

INMODE - 4 s INFILE - 3 
INPÜT INFILE? 

OPEN «INFILE.INMODE,0,INFILE? 

deacriptiom 

The OPEN atatement allow. a disk fil. <or «"F dev ^*' 
for that matter) to be linked to « fil* 

( channel) for futura refaranca in connection with fil 
input/oüput in.truction. (e-g.. PUT.GET, INPUT.PRINT. 

CLOSE). 

COMMENTS on argumentai 

The fn argument allow. for a numb.r betwe.n l and 4. 
The number 0 ia re.erved for th« acreen and c »" 
uaed in Atari BASIC (though it ia “1}°"^ X ali 

After a fil. ha. been OPENed with a given fn. all 
referencea to that file muat be made uaing that «am« 
fn. 

The aexpl argument allow. th. uaer to OPEN « fü« tot a 
apecific “mode*, according to th« followlng tabl.i 

Mod« 4i will OPEN the apeclfied fil. for input 
only. Thua you can only retri.w. data 
from th. apecified fil*. 



Mod« 6i allow# you to acceea the directory on 
th« dlak. 1 

Hod« Bi la th« oppoait« of mode 4. That i«, 
data can only b« ator«4 to th« apecifiad 
file. See balow for notaa whan uaing 
»od« 8. 

Mod. 9| 1, uaed to add data to th« epacified 
file. Th« data that 1« added will begln 
at th« current «nd of the apecified 
fil«. 

Mod« 12ti« uaed to acceaa th« apecified file for 
input AND output. Thua data can be 
«tored and retrievad from th« ap«clfi«d 
file. ■. 1 

NOTE« Aftar OPENlng a fil«, th« apecified fil« number 

^ U *nfe»°a d !?. l9nSt * ln other I/O atatamanta. 

Two OPENed fil«« cannot have th« «am« fil« numb«r, but 
it la poaaible to OPEN th« «am« fil« with two different 
fil« number«. Ganarally, auch a double OPEN will have 
dlaaetroua reaulta. BEWARB« 

NOTE« If a fil« l# OPENed for output (a«xpl-8) and th« 

til * do ** not •* 1>t th«« ■ fil« with th« 
apecified nam« will b« created for you. If tii« file 
apecified already exiata. it will b« deatroyed and « 

new fü« with the apecified nam« will be created for 
you. 

0PENed for update (aexpl-12) can NOT be 
appendad to under DOS XL veraion 2 or under Atari DOS. 

Nute« Mod« 6 ralght, for axampl«, be uaed from BASIC to 
find what file« er« on « dlak and thereby allow a menu 
P 1 * f? l low Ing program will allow a menu 
* U BASIC SAVEd program« on driv. I. 
providing that th« program namea do NOT have an 
extenaion (i.e., the programa ahould have b««n SAVEd 
eimply aa Dinaat«- inatead of aa *Dinam«.«xt*) . 
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EXAMPLE* 


r °“ (wl Lllo/lor 

T _ iiicl} 2)«* " THE« PRINT I,LNf(3,l») ‘ —- 
U9 ir .. C o»d char.cfr i. not ♦ bJUnx 

v* just read the lina "NNH FREE SEC.— 
which appeare ae ia«t Um °* dlrecto- 

13fl CLOSE 11 . OPEN |1.6,0.“D.*“ . . 

130 CLOSE JU fc r re * d ' th . alractory agai») 

140 PRINT » PRINT “WUAT PROGRAM TO RUN | 
j!g i"pui J , xr J>-I TUEN GOTO 140 

® (if program nurobar i« too big# try 

160 FOR I - l TO J I INPUT fl,LN? » HtXT * 
(eearch for the program user wanta» 

i,« -p.-i 

longer than 10 characters) 

Tty typing thi# * w th “ n * o^tül by*typlng S Ru5 “D^MENU**' 
Later, you ca» uae the program cy «-yp*"* 


r x HEXT I 
..t-iank, 
rrr,.~roRS* 
=xotory) 


k _eaain) 



4.9 POINT 


comraandi POINT 

purpoaei Thio coramand requesta a Change of the 

current phyaical dlek locatlon of an 
OPEN £ile £or later acceaa by aome I/O 

comraand or Statement. 

ueern BASIC XL and Atari BASIC usara 

uaage» POINT Ifn, avarl, avar2 

argumenta* fn - file number Prora 1 to 7 

avarl - a variable which apecifias the 
dealred aector number 
avar2 - a variable which specifiea the 
byte offsett within the 
deeired aector 

exampleai POINT II. SECTOR. BYTE 

POINT IINFILE, S, B 

deacription* 

Thls command generally requirea an in-depth 
understandlng ot BASIC and data filea on the part of the 
programmer before it can be ueed properly. 

“Version 2* of both DOS XL and Atari DOS maintaina only 
sequential fllea, wlth a forward link and file number 
check occupylng the laat 3 bytes of each phyaical 
aector. Veraion 2 providea no direct random-acceas 
capabilitiea on a file levelr and, without the uae of 
NOTE and POINT, the programmer ia reatricted to raading 
and updating a file by starting only^ at ita beginning. 

However, thanka to NOTE and POINT and the fact that the 
forward link includea a file number check, the 
experienced programmer may create hia/her own random 
acceaa Index into either an exiating file or ona being 
bullt. 

POINT aimply specifiea a dealred diak aector and byte 
offaet within that aector for any currentiy opened diak 
file. If the aector specified ia actually part of the 
diak file OPENed on the given channel, and if the byte 
Offset ia valid, then " the next acceaa Co that file 
Channel (either input or output) will take place 
starting at the raqueated locatlon. Generally, POINT ia 
only valid for moat operationa when the file haa been 
OPENed for update (mode 12). 

See section 4.7, NOTE, for an example prograra. 





4.10 PRINT 


commandi PRINT 

Thi* conunand put« th« ASCII «quivalent» 
of the gtv«n »xpraiiioni to th< ftl« 
•pecified or the «cre«n. 

BASIC XL and Atari BASIC u««r« 

PRINT Ctfn ,3 exp [.exp...3 {.} (ll 
fn - file number 1-7 

exp - the expreaaion can either he a 
r atring encioaed ln double quotea, 
a atring variable, or a numeric 
variable. 

PRINT #3,"hi th«ra",l,2,3 
PRINT »OUTPILE. NAME? 


deacrlptlon« 

- riu nuniber ia uaed with the PRINT conunand. the 
!^!clfifd are PRINTed to th. dl.k fila that 

ha» been prevlouly OPENed uaing the aama. fila number. 

NOTE. Character. are PRINTed to a dlak file ln * * an "“ 

identical to the vay charactera “ r ® 

acreen if the Eile number Option la not.uaed. 

NOTE. A after the Ifn cauaea tabbing befor. the 

* t VrVt character l. PRINTed. A doea not caua. th. 
tabbing. Normally, the aemlcolon ahould be uaed. 

See INPUT (a.ction 4.4) for »ore Information and an 
«sample progr**#. 


purpo*«» 

u«er«i 

usaga» 

argumentst 

•xamplea < 


4.11 PUT 


commandi 


purpoa.i 


thia atatora.nt ia uaed to atore a 
aingle byt. of data to a apecifi.d Ulm 

Atari BASIC uaara with OS/A+ 


U *° r * 1 Atari BASIC uaara with OS/A+ 

“•*9««- PUT tfn.avar 

argumenta, f n - m. nunb4C x _ 7 ' 

••*P - an arithm.tic expreaaion 
' axampleai PUT 13,65 

PUT 1OUTPILE,ASC(“A"1 

deacrlptlon, 

Th. PUT atatement 1. u.ed to output a alngl. byt. of 

data to a »pecifled fil*. Th. file number uaed in the 

* U f fc b ® ° n * th4t h4 * b “ n Ptevlou.ly u.ed 
in the aucceaaful OPEN of a fila. r 

NOTE« Data that ha« been atored in a fila uaing tha PUT 
atatement. C4n U>U4lly ° nly b * *«trl*ved u.lng 9 t h. CET 

See GET (a.ction 4.3) for 4 program axampla. 
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4.12 SAVE 


commandi SAVE 

purpoaei conmand will atore a BASIC program 

pn dia* ln (nternal format (not 
ATASCII). 

Uteri BASIC XL and Atari BASIC ueara 

uaago* sXyi2 

argumenta« fileapec - filenama you wlah EP SAVE 

you program under. 

examplea I SAVE "D2IGAME.SAV 

SAVf FILEf 

descriptlon 

The SAVE command ia uaed to SAVE your BASIC program ln 
ita internal format. Thia format 1* uaually amallar 
then the text form of your program and will take up 
lass room on your dlalc. All programa SAVEd to the dlak 
muat be pepntered uaing the LOAD or ftt'N commanda. 

See deacriptlona of LOAD and BUM for »or# exampUa and 
further explanatlone, 


4.13 XIO 



command« XIO 

purpoae: Thia la BASIC*a catch-all Input/Output 

command. If BASIC doean’t provida a 
tunet Ion to acceaa a partlcular featura 
of a device or file, aome for» of-XIO 
can probably be uaed to do ao. 

BASIC XL and Atari BASIC uaera, 
but aaa notea on Individual aubcommanda 

XIO aubcommand. Ifn.auxl.aux2, fileapec 

aubcommand ~ see deacriptlona in aub- 
aectiona which follow. 

in — a file number. In contraat to 
moat OS/A+- I/O commanda, XIO often 
regulrea that the file number be 
that of an UN-OPENed channel. The 
aubcommand dictatea the uaage 
here. ao aee deacriptlona below. 

auxl and aux2 — generally zero. These 
valuea _ are paaaed to OS/A+- 
unchanged (and thenca to the 
devico being acceaaed). ao the 
Individual device(s) may reguire 
other valuea. None of the 
examplea given in thia aaction uae 
theae valuea. 

fileapec — a proper OS/A+ file nana. 


users< 

• 

usagat 
«rgumentsi 



Although, aa noted, XIO can be uaed for aeveral 
puirpoaes, we will restrict our diacuaalon here to those 
tour aubcommanda roost uaeful to the Atari BASIC 

SSTErS; rJfll m ° ra deta , u ' r «“vge.t Chapter 10 of 
Ihi aiI-i X n«£'f“ ren “ roanual «nd other aourcea, auch aa 
the Atari 850 Interface Hodule manual. 


The aubcommanda to be diacuaaed will aach be 
a aeparate BASIC command. 


traated aa 









aubcommandi 


REN AM E 


purpoaei May bo uaed to rename diak filaa. 

uaaga. XIO 32, *fn, 0, 0, fileapac 

argumentai fn — tha Ul. numbar of an UN-OPENed 

Channel. 

fileapec — a proper OS/AR flla nama 
folloved by, ln tha aaraa BASIC 
atrlng, a conuna and a aecond flle 
name. Tha aacond flla nama may 
HOT Includa a diak driva 
apaclfiar. 

deacrlptioni 

It ia augge.tad that "fn". the flle numbar, be 7, eince 
that Channel ia normally reaerved for ay«tera . 
functiona (which thla certainlv ia). The only 
atrange about thla aubcommand ia tha form of tne 
fileapac. Sorae examplea follow« 

XIO 32,17,0,0, *D« TEST. SAV, OLDTEST. SJ^V" 

DIM FL?(100) 

IHPUT FL? 

FL?(LEN(FL?) Rl) - *,BACKUP" 

XIO 32.17,0,0,FL? 

Agaln, note that the aecond flla name in both examplea 
ia HOT preceded by a diak drive apaclfiar. 


T*HOTEi Although BASIC XL uaera may u.a XIO to I 

I perform thla aubcommand, BASIC XL providea an 

I eaaier method of accompliahing tha aame functlon 

I via ita REHAME command. Sea your BASIC XL manual I 

I for further detalla. _ ' 


''•IWltJU* 


!*>.. «...4 -„u.“«, 
tfiFe*? u * €d to «m« di«* 


u««9«t 

argumentai 


deacription« 


*10 33, |f„, 0< g t fa.. pcB 
channli. th “ * U * nu * Ur °t an UH-OPENed 

with P C *wild Pr °ard n *“*. 

Proc....d. ’ * cc *Ptad and 


apeciflad. and^lp^h^f m* 1 ?** ° n th * diak driva 
aubcommand), tha fpacieua l ‘ f |j > "°t PROTECTEO ( aaa naxt 
araaed (delated, killed «.T 1 ! 1 b “ P«r“*nently 

UM| aapped) from tha diak. 

cfrd" T "a S fiU B nam^ c lüdI”g C ^ TI °“* * >ild 

‘ will ara.a ALL fila. which »ftc"^. 

Cxarnploss 

XIO 33.17 0.0,"D2 l0 LDPROG.SAV- 

name "ldpr^s ‘‘"f ‘ “ l * -*«• tha 

drive 2. PR0G>SAV * ro » tha di.katta ln 

XIO 33,(S,0,0,".BAK“ 

i\ l . f “^. h r tn9 ; 

in driva 1. ' * BAK trom th * «Jiakett. 


j perform A 1 thU 9 h , u bco^ ar ^ b bäIiS xl* ““‘l / 10 t0 f 
foC i t "alf ,,AaE co ™" a " d - fli Cf BAllc“ ra fr <U " Cti0n ! 

I for further details, * our BASIC XL manual j 







aubcommand« fROTRCT {«1*0 called "LOCK") 

purposet Hay ba used to protoct dlak fiiea fron 

accldenta) erasura and modificatfon. 

XIO ?S, ffn, 0. 0, fileapec 

fn — the flla numbar of an UN-OPENed 
Channel. 

f i1espec — a proper OS/A+ fila nama, 
with ' "wild carda* acceptad and 
jp'rocessed. ' 

deacriptioni 

All fllaa on tha apeclfled drive which hava namea which 
natch the apeclfled flla will be "PROTECTED“ by usage 
of thla aubcommand. Protection in tha OS/A+ 
envlronment flmply conalata of aettlng a fiag ln the 
dlakette'a file dlrectory which teile the OS to 
diaallow either modifIcatlon (l.a., OPENa ln modea 8, 
9, 12, etc.) or erasure of the file. Any OS/At- 

DIRectory listlng will ahow protected filaa b^ meana of 
an aaterlak ln the £iret coluran of tha diaplayed llnea 
(unprotectad fiiea havo aimply a apace in that 
Position). 

Examples > 

XIO 35, #7, 0, 0, "Di*.** 

will protect ALL flies on drive 1. 

XIO }5, fl, 0, 0, “04iDOS.SYS" 

will protect only tha flla named 

"DOS.SYS“ on the dlsketta in drive 4. 


I NOTE« Although ..BASIC XL usera may uae XIO to I 
I perform thla aubcommand, BASIC XL provldea an I 
I eaaler mathod of accomplishing the same functlon I 
I via ita PROTECT comraand. See your BASIC XL manual I 
I for further detalla. j 


uaagei 

argumenta« 


aubcommandi UNPROTECT (also callad "UNLOCK") 


purpos«i 


uaag«; 
Argumentss 


dsscriptiont 


Mav b« u««d to unprotect dlak flies to 
silow subeequent erasure and 
modificatlon. 

XIO 36, Ifn, 0, 0, fllespec 

fn — tha flla numbar of an UN-OPENad 
channal. 

fileapec -- a proper OS/A+ fila nama. 
“Ith wild carda* accaptad and 
procaased. 


All fiiea on tha apecifiod driva which hava namea which 
match the apeclfled file will be "UNPROTECTED" by usaga 
of thla aubcommand. Protection ln tha OS/A* 
con • l,,t • ot »«tting a flag in the 
üi dlrectory which talla tha OS to 

diaallow either modification (i.a.. OPEN, in modea 8. 

etc -', or erä » ur « Of tha fila. Any OS/A+ 
DIRectory listing will ahow UNprotected flies by meana 
or a apace in tha firet column of the diaplayed linas 
(protected fiiea hava an aatariak in that poaition). 

Examplesi 

XIO 35, #7. 0, 0. -02»».COM" 

will unprotect all filaa on driva 1 
which have a filename axtanalon of 
•COM". 

XIO 35, II, 0, 0, "Dl«DOS.SYS" 

Y*“ " n P rotöCt onl y tha fila named 
DOS.SYS on the diakatte in drive 1 
(thia Step ia neceaaary befora eraslng 
that file. as you might do to gain mora 
apace on the diakatte). 


NOTE« Although BASIC XL uaers may uaa XIO to I 
perform thia aubcommand, BASIC XL- provldea an I 

acco ™P“»hing the aame functlon 
I via ita UNPROTECT command. See your BASIC XL manual 
I for further detalla. j 
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Sectlon 5i INTRINSIC DOS XL COMMANDS 


Inatrlnslc Commanda are one claaa of coitunands which can 
be given anytlme the Dli (ot D2i. etc.) prompt appaara 
fron tha DOS XL Comroand Processor. 

The Intrlnslc Commanda deacribed ln thla chapter are 
executed via Code that was loaded lnto the aystem at 
bootup time. These commanda do not require the loading 
of programa to perfonn their functiona (aa do extrlnsic 
commanda). The following ia a aummary of tha most often 
uaed intrinaic commandai 

DIRECTORY - List Directory 

PROTECT — Protect a file (from Change or eraae) 

UNPROTECT - Unprotect a fiia 

ERASE - Erase (delete) a file 

RENAME - Renamea a file 

LOAD - Load a binary file 

SAVE - Save a binary file 

KUH - Execute a program at aome address 

CARTRIDGE - Run Atari cartridge in the “A“ 

cartridge alot (Atari uaers only) 
TYPE - Type a text file to the acreen 

g -.Start a batch file execution 

On, - Change default diak drive 

and there are a few othera. 

All intrinaic commanda may be abbreviated to their firat 
three characters. Aa a matter of fact, OS/At only looks 
at the firat three characters whlla teating for an 
intrinaic command. Each of the commanda will be covered 
in detail lat.er ln thia manual; however, to glve you a 
feel of the intrinaic commanda, let'a iook at the 
DIRECTORY command. While looking at theae examplea, 
asaume the “Dli" at the beginning of each Une ia the 
. default device and haa been placed on the acreen by CP. 

Dl»DIRECTORY Hat all filea of diak on drive one 
Dl »DIRTY * * * ' " * * 

D11 DIR * .... 

Dl.DIR *..; I 

Dl»DIR Dl» 

Dl> DIR Dl«*.. 

Dl DIR D2. iiat all filea of diak on drive tvo 

Dl»DIR D2 » *.* - * " ’ “ “ “ ‘ 

Dl»DIR ».OBJ filea wlth extenaion .OBJ on drive One 

Dl»DIR D2 » *.ASM filea with extenaion .ASH on drive two 

Detailed explanationa of all Intrinaic Commanda follow, 
preaented in alphabetical Order. 


.LJ » 


. I 


S.l t 


command» 


"1 


purpoaa« 


uaage» 
argumenta« 


Thla command begina execution of a batch 
Command file 

(file-narae 

‘ ' * 

The name of a .EXC file contalning CP 
commanda. Tha name ahoul4 be uaed 
WITHOUT tha .EXC extenaion. 


Deacription 

The 8 command teils OS/A* to begin taking commanda from 
a batch file. Thia fiia ia a text file which may 
contaln both intrinaic and extrinalc OS/At commanda. 
for exarapie, auppoae tha flie TEST.EXC containa tha 
foilowlng commanda» 

DIR D» 

DIR D2< 

EHD 

laauing tha command 
«TEST 

would teil OS/A* to atart taking commanda from tha fiia 
TEST.EXC. At that point, a directory liating pf drlva 
1 would ba given, followed by a liating of filea on 
drive 2. 

See aectlona 9 and 7.6 for more Information on craatlng 
and uaing batch filea. 

KOTE» The .EXC extenaion ahouid NOT be given as part of 
the file-name when laauing the I command. Tha command 
8GE0RGE ia aufficlent to begin execution of the fiia 
GEORGE.EXC. In fact, an arror may rssult lf tha 
command 8GEORGE. EXC ia trled. 

NOTE» A CAR ccmmand, when encountered wlthln a batch 
file will atop batch execution. 
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5.2 CAR 


commarv} i 
purpoaai 


ThU command tranafec* control to 
cor^ridge 


uaagat 
argumantf| 


Deacrlptioo 

The CAR command ^““ratalnHcontro^^^the 

fron, DOS XL. Th. Cartridge will *«J" th . 

ayatem untl* » DOS command la ,x.cut.a r 
cartrldge. 

CAUT10H. Soma cartrldgee ^^"“^^{^a^cartrldgea. 
and thua DOS XL capnot be uaed wlth tpeae 

If „o cartrldge l. - pr.a.ot. M.lng thl. commapd will 
cauae an .r-;c meaaage to be glven- 
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5.3 Dni 


command t Oli or D2i or D3i or D4a 

purpoa«, Thia command Chang.a th. d.fault 

di.k drlv* d.algnator. 

u.ag.t Dm 

mera. Own.ra of .or. than on. dlak drlv. 

Descrlptlon 

Whon.v.r th« conaole procea.or of DOS XL la r.ady to 
accept a command fron, you. It prompt, you wlth *D1«- 
3hit Prompt aarvaa a aecondary purpoa.1 ft r.ralnda you 
what the current d.fault dlak drIvrde.lgnator 1 ? * 

Win.ini • fllename to CP (ln elth.r an 

^ axtrlnaic command). if you omlt the diak 
cllrHill: c f P“ flxe * th. filename 3lth the .am. thre" 

PR^ECT GEORGE nlr^ Pt ‘ y °V " lth <••9*. Thua? 

rKOTECT GEORGE.DAT la aeen by the protect «ecutioA 

3 ^ry ^ut R 2 het 3 !GE ° RGE ' DAT ' * nd Lt doa « not hav « to 
pr3fi,? Wh * ther or not you u « d • prop.r drlv. 

If you have mor. than one drive. how.v.r. it la 
aometimea conv.nient to d.algnate . drlv. oth.r than 

*D 2 - a° ne ** tha default dlak drive. So, if you type 
D2. ln reaponae to the DOS XL prompt. CP w!U acquITt 
a new prompt (-02,-) and any file. civen wlthoSt ! 
drlv. d.algnator will b. prJum.d to b2 o* drlÜ 2 * 

"tlnd^rrt^ 003 XL aCtually »upporta 01. through 08,. but 

D4.? Driv« V froT y b “ ° n l y b ° addr “*® d »• Dl« through 
be ihl. fr °r* * ome other rnanufacturera may poaaibly 

b« able to ua. the additional deaignation.. ^ Y 


! 02 u , 710 t‘ o a?,‘ hipped ' oos xl can ®"ir»e«M“wr~3Ti' 

I 7?5',n3°Ap“ndirA?” t0 oth « d «^«. ..ctlon j 
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3.4 DIR 


DIRoctory 

Th« command allen.« th« u««r to *l«w th« 
diak dlractory 

DIR [Dn«HfU«-nama] Coutput flU-«p«c] 

optional fil« «pecifler 
optional output fil« apacifiar 


Daaeription 

Th« DIR command ««archea th« diek dlractory of th« 
apacifiad diak (or th« cucrant dafault drlv«, ** ?n« *• 
oraittad) for all flle« matching th« fil«-apacifier. 
Th« naraaa of all file« matching th« apacifiar ar« than 
printed to th« acrean, together with th« Ungth of th« 
fil« (in aactora). Rn aatariak pr«c«dlng the fil« « 
name indlcataa that th« fil« i« prot«ct«d fron «raaur«. 
vritlng, or renamlng. 

Th« fil«-apacifi«r may ba any valid fil« nam« («e« 
aactiona on fil« atructur«) and nay 

*wild-card* charactera *?* «nd '•*. A quaatIon mark 
(•?•) will match any charactar in a fil« nam«, whil« 
an aatariak (••') will match any atrln? of *«ro or »or« 
charactara. For «xampl«, 

DIR AB*.C?7 ’ • 

will match and Hat 
ABX.CXX 

AB.CUR ' 

ABCDEP.CNH 
• tc. 

If tha output fil« nam« l« apacifiad, th« 
liating will b« 'a«nt to that fil« in«t«ad of to th« 
acraan. For «xampl«, th« command 
DIR Dl« P« 

will «and to th« print«r a liating of all fil«« on 
driv« l. 

CAUTIOMi Spaclfying a diak fil« n«»« a« an output fil« 
nam« will not g*n«rally work unl*ae th« output fil« l« 
on a diakatt« oth«r than th« on« givan or impliad by 
th« firat fil« ap«cifi«r. 


command ■ 
purpoa«« 

uaaga« 
argumentai 
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EHO 


1 EHD 


command« 

purpoa«« Stop batch «xacution fron withln an 

«x«cuta fil. " n 

uaaga« EHD 

argumenta« non« 


D«acrlption 

SL “Lt^n C,U r a 003 XL t0 ,t0 P raading command« 
commmand. tCh n }* * n<1 to r, * u “* prompting th« uaar for 
fiU. l * command h«« no «ff.ct outaid« of « 



4 

J 

i 

i 

j 

j 

\ 









5.6 ERA 


ccramandi ERAft 

purpoaa'i Thi« command r«mov«f filM fr«» * d i»* 

uaagei ERA [Dn« ]fll«-nam« 

argumantfi a fil« •P»5l(fW »trln^ 


Deacriptioq 

Th« EKA command permanently reraov«« fll«« Crom » di«k. 
All fila« matchlng th« flle-»P«clfi«r atring on th« 
•p«clfl«d driv« (or th« current default driv«, It Dn» 
ia cmittad) will fee araaad fron th« diak. Th«a« fil«« 
will no long«r b« «hown when a DIR coounand ia iaauca, 
nor will they b« «vailabl« for any typ* of ffl« acc.a«. 

WARtUUGi Aa thla command caua«a th« • lrr«ver*ibl« 
delatlon of filee from th« diak, it ahould b« u««d with 
car«. Ua« th« PROtect command to guard fila« againat 
accidental «raaur«. 


Examplaai 

ERASE ?.BAK 

will eraae all fil«« with an «xtenaion 
of .BAK that ar« unprot«ct«d and that 
reaide on th« current dafault driv«. 

ERA DJiDUP.SYS 

will «raae th* fll« nam«d DUP.6YS fron 
di*k in diak driv« numbar ?. 


Hot««i ‘ ‘ - _ 

If ERA«« doea not find any «raaabi« fll«« that 
match th« *p«cifi«r. it will r«turn « PILE HOT 
ROUND «rror. 
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5.7 LOA 



} 


comrnand i LOAd 

purpoa«i Load diak fil«« into mamory 

uaagei LOAD CDni]fila-nan« 

argumentai a fil« apacifar 


Deacription 

Th« LOAD command allowa th« ua«r to load binary ioad 
Image fil«« into uaar memory. ' Th« fii«a muat ba 
compatibl« with th« normal binary objact filea ua«d by 
th« normal hoat Computer operating ayatem. That iat 

Each aegment of th« memory Image fil« muat b« preceeded 
by two addreaeaa, th« atarting and «nding addraaaea in 
RAM memory of th« aagmenti Th« «ntir« fil« muat be 
precaedad by two bytaa with all bita on ($FP. 5PF). 
Thla format ia identical to that produced by Atari'a 
Aaaemblar/Editor Cartridge and moat upgradad producta 
(including ACTION and KAC/6S from OSS). 







S.S NOS 


commandi NOScrean 

purpoaei Turna off command acho to acraan during 

batch 

ueagei NOS 

argumenta i nona . ? - f 

Deacrlption 

Normally, all commanda ancountarad durlng batch 
axecution ara echoed to the acraan aa lf thay wäre 
typed in by the uaer. The NOS comraand can be used to 
prevant thia acho. KU commanda vithln an execute file 
will then no longer be achoed until tha executa file ia 
atopped for any reaaon or a SCR comtnand ia encountared. 

Thia command only affacta commanda ancountarad in batch 
mode. 


5.9 ?>rc 


comnamtx _rcx;;: 


purpoae 


uaagai; 


PROtact 

Thia command protacta filaa fro« accidan 
tal araaure, writing, or ranaating 

PRO COn<]fila-nama 

a fila apaclfiar 


Deacriprc: 

Tha PP.c. 
filaa tr= 
filaa aa. 
The ,jyi t. 
•ateriax 
uaed. 
protactix 

gXAMPr. Pg-r 


7 “' Command allowa the uaar to protact ona or mora 
.T 0 * araaure, writing, or ranaming. KU 

atching tha fila—apacifier will be protactad. 
mvatam marka a protactad file by plactng an 

n,xt to nanl8 whenavar a DIR command ia 

-Tha UNP command can ba uaad to diaabla tha 
vhen desired. 

-IßlaJPRO •.* 

Ioo„ w ii l - pcot,,ct * 11 m « 8 on drlva 1 
--IDI 1 IPRO D2 1 *.COM 

will protact all filaa on drlve 2 which 
have an extanaion of "COM" 







5.10 REM 


« 


comraandi REMark 

purposei Print* remarka to tha acreen durlng 

batch axecution { 

• 4 

uaagei REM any charactere ' 

argumentai a ptrjng of raro or asor* charactar* 


Deacriptlon 

The REM command performa no Operation whatsoavar. It* 
aola purpoae 1* to provida a mean* of aaally printlng 
meaaagea to the icraan f rom an executing batch file 
(aee aection on batch 'axecution). Whan ancountered 
durlng batch axecution, the command line containing the 
REM command will be echoed to tha acraan, unlee» the 
MpScrean command ha* bcen pravioualy laaued. * 
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5.11 REN 


commandi RENama 

purposa t Rename a file to a naw nein* 

ua aget REN from-flla-nama to-flte-name 

argumentat two fii* namea 


Daacription 

The REN command will aearch the apeciflad diak (or tha 
default drive. if Dni ia not apeclfled) for a file 
whoae nama matches the apeciflad from-flla-nama. If 
tha flle ia found, ita name will be changed to the 
indicated to-file-name. An error occura if tha 
from-file ia not found on tha diak. Tha to fila-nama 
ahould NOT be preceeded by a diak drive apecifiar. 

HARNINCt The REName command ahould not be uaed wlth 
wlld-card charactera (**'.*?"> in tha flia namea. 
Such uaage may permanently damage your diekette 
directory. 

KARNINGi Under veraion 2 of both DOS XL and Atari DOS, 
it ia poaaible to uae the rename command to create two 
filea with the aame name. If thia condition occura. 
uae the COPY command with the query (-Ql Option to 
transfer the two filea to separate diaka where they may 
then be renamed back. 

rc, 

(Dls)RENAME TEST.DAT TEST.BAK 

will rename the file “TEST.DAT on drive 
one to “TEST.'BAK* 

(di iI ren d2idosxl.sup dosxl.sys 

will rename the file “DOSXL.SUP“ on 
drive two to “DOSXL.SYS“—note that the 
drive apecifier waa NOT given for the 
new filename 
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5.12 RUH 


commandi RUN 

purposo« This command tranafers control to an 

* addroaa in mamory 

uaagei RUN Chex-address] 

argumenta■ an optional hexaddciraal addrasa 


Descrlption 

The RUN command imroediately cauaea OOS XL to perforro a 
Jump to the indicated addreaa (or to tho addreaa 
contained ln the CP'a RUNLOC« if no address isglvenj. 
The hex-addreas, if preaent, muat conalat of 3 or 4 
hexadecimal digits. 

The addreaa in RUNLOC ia aet any time an extrinaic 
command ia iaaued or a program la loaded ualng the LOAD 
command. Therefore. the RUN command may ,be used to 
reenter a prograra auch aa BASIC after leavlng the 
progr&ra through a DOS command. 

IMPORTANT NOTE* 

Moat atandard DOS XL Interactive ayatem programa will 
aet RUNLOC to point to their Warmstart entry point. 
Thua, for example, if the uaer returna to DOS in Order 
to perform an INTRINSIC command, he/aho may reenter the 
ayatema program by simply typing RUN. At the current 
wrltlng, BASIC A+ and MAC/65 (for example) both follow 
this protocoli aimply type RUN from CP to reenter at 
their warmatart pointa. 


3.13 SAV 


commandi SAVe 

purposei Save a portion of Memory to a diak file 

uaagei SAVE file-spec start-addrasa end-addresa 

argumantai a file specifier . 

a hexadecimal atarting addreaa 
a hexadecimal ending addraaa 


Descrlption 

The SAVE command allowa the uaer to writa portion« of 
Memory to diak flies in Standard binary file formet. 
The bwo addressaa deflna the portion of Memory to. be 
wrlttan to diak; the aecond addreaa muat be greater 
than or equal to the firat. A fila which hat been 
‘aaved* may be later returned to mamory uaing the LOAD 
command. 

Examplet 

SAVE PAGE4000 4000 40FF 

This example will aave the 2S6-paga of Memory at 
$4000 to the diak file PAGE4000 on the current driva. 










5.14 SCR 


cocwnandi SCR«en 

purpoaa« Cause batch commands to b* #choe4 to th« 

- fcrttm 

usagei 8CR 

argumenta< non« 

Deacrlption 

The SCR command cauaoa commands encountered during 
batch execution to ba achoed to tha screen. The NOS 
command may ba uaed to turn off tha acho of batch 
commanda. 

Thia command only effacta commanda ancountarad in batch 
mode, M - 





5-15 TYP 


command« 


purpo®«* 


argumentai 


Thia command typaa an aacii or ataacli 
fila to tha ecraen or anothar flla 

TYP [Dm Jfila-nama Coutput-fiiaü 

filenama - tha name of any taxt fila. 
output-fila an optional output fila. 


Oeacrlption 

Th. TYPa command allowa tha u.ar to copy taxt fil« 
tha acraan or anothar fila. If tha optional ontput 
fila La not apaclfied. tha text fila Indlcated will ba 
cooied to tha acreen. Tor exampla, to view tha 
commanda ln tha STARTUP.EXC fila ön your OSS maat.r 
dlskette. laaua tha comman4 

TYP STARTUP.EXC 

If tha optional output fila la apecifled, tha taxt fila 
will b. P copiad to tha output fila. Tor exampla. to 
copy tha STARTUP.EXC fila to tha prlnter. laaua t a 

command 

TYP STARTUP.EXC P« 

Anothar uaa of TYPa la to craata • taxt «1U- T ^Jp 
alaewhere ln thia manual, you can craata a naw STARTUP 
batch fila via tha followingi 

TYP El STARTUP.EXC i 

when E. ia tha aourca “fila*. aa in thia axample. you 
must uaa a C0NTR0L-3 (hold down tha CTRL. key 
31 to terralnate tha entry (thia craataa an and of £Ut 
slgnal—alvaya true fron Ei but not well documented by 
jLtÄrll »igo. you may not u®« th® cunor control k*y® 

to edlt any llne for which you hava ^aÜ^text 

RETURN key. Thu. thia mathod la handy Jfor amali taxt 
filaa but not ba uaed aa a general fila craator. 

Tinally, tha TYP. command may also ba uaed to copy TEXT 
filaa fro» ona di.k fll« to anothar by u.ing dlak fila 
names for both tha Input and output filaa. 
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5.16 UNP 


command ■ UNProtact 

ourpoaai Thl. command remova« thaprotaction 

purj« cauaed by th« PRO command 

uaagei UNP [Dm]«ila-naa»a 

argumantat * HU apaolflar 


Description 

Th« UNP command .Uo«. tha uaar to ramov« th. «:1t« 
protection cau.ed by tha PRO con»and «o that fil« 

*j« araaed, renamed, or wrlttan to. Air 
matchlng tha flla-apeclfler on th« «peclfled«äriv« ( f* 
tha current default drlva, 1« Dn« ia omitted) will be 
«ffected. Thea« tile« «Ul «“> longer b.^.hovn with a 
praceding aatarlak when th« DIR command la uaad. 

EXAMPLES« 

(Dlt)UNP *.BAK 

will remova th« protection from all 
filea on driv« 1 whlch hav« an «xtanalon 

of “BAK“ 

, fDlilUNP D3»DOSXL.SUP . 

will remova tha protection fron only th« 
fil« 'DOSXL.SUP* on driv« 3 
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Sactlon 6i EXTRINSIC DOS XL C0MMAN03 


Tha «xtrinaic command« ara programa that ara run by th« 
Command Proceaaor (CP) of DOS XL. Any binary fila 
contalnlng tha .COH extenaion may ba uaad aa a DOS XL 
«xtrinaic command. Th« DOS XL COPY command ia on« auch 
«xtrinaic command. If you parforn th« DOS XL DIRECTORY 
command on th« aaatar diakatta, you will aa« a fila 
named COPY.COM. Th« program in th« COPY.COM fila ia 
what ia «xacutad whan th« COPY command ia typad. 

Remembar, «xtrinaic command« ara «xtarnai ’ to tha 
oparating «yatem. Whanavar an «xtrinaic command ia 
«xacutad fro« DOS XL. th« ayataa MUST go looking on th« 
diakatte for a .COM fil« aaaociatad with tha particular 
«xtrinaic command ixauad and load that fila into tha 
ayatam. for axample. whan th« «xtrinaic command DUPDSK 
ia «xacutad tha ayatam will go looking on th« diakett« 
in driv« 1 for a fil« call DUPDSK.COH. If th« command'« 
.COM fil« la not on tha diaketta tha ayatam will raturn 
a FILE NOT FOUND «rror. So remambari whanavar you laaue 
an «xtrinaic command to tha ayatam ita .COM fila muat b« 
on tha diakatte for tha command to axacuta propariy. 

Whenevor th« uaar type« a command to DOS XL. tha command 
(firat thre« charactara only) ia comparad to tha 
intrlnalc command Hat. If th« command ia not in'th« 
lntrlnalc liat, it ia aasuraed to ba «xtrinaic. A 
conaequanca of this ia that no «xtrinaic command program 
may atart with thre« charactara which match any of th« 
intrlnalc command«. For axampi«, a program named 
PR0CESS3•COM' ■ could not ba call by aimply typing 
"PR0CESS3*. aince 0S/A+ would viaw that aa tha intrlnalc 
command “PROtact*. Solution«i 

(1) Rename tha «xtrinaic command fila. 

(2) Typ« tha command«i 

LOAD PROCESS3.COM [RETURN] 

RUN [RETURN] 
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To procaff an axtfinalc command, Doq XL wil|| 

|| Profix tha command with tha dafault devica (if 
a doyica ' if not specifled). 

2) Attäch tha «COH axtenaion to tha coausand. 

3) Opan tha ganaratod flla spec for input. 

4) Taat ffla for progra« of proper LOAD fila for»at. 

5) Load and efecute tha progra«» 

HOTEi ff) ff any elemant of tha procedura falle, 
varloua arror »eeaagee will raault» 

(ii) Stop 1 of tha procadura impllaa that a davica 
may ba apaclflad, Thia If in fact tne caaa. 

Davor axpllcitly apecify tha »COM axtenaion aa part of 
tha command. Tho command COPY.COH will raault ln a 
flla apac of DliCOPY.COM.COM, whlch ia invalid. 

Soma axtrinaic commanda (auch aa COPY) ara auppfied by 
0S3. Tha nuraber of poaalbla axtrinaic commanda ia not, 
howevar, limited to thaaa few» commanda may ba written 
by tha uaar to perform virtually any functlon. If you 
ara intraated ’ in writing your own axtrinflc commanda. 
aea Chaptar 8. 

-If an axtrinaic command (i.a., a program running in 
RAM) haa control, tha program may ganarally ba rarun or 
rttontcrod by •loply uiing th* RUH coas&an4 without 
parametara. Execptiona to thia rula ara tha axtrinaic 
commandf COPY. C0PY2f f SDCOPY and CONria. 

Thia chaptar givea a deacription of aach axtrinaic 
command auppliad aa a atandard part of an DOS XL ayetem 
master diafcatta (axcapt that aoma commanda «ay ba 
apacific to partlcular varaiona op packagaa). 


C.l C65 


command > C65 

purpoaai thia command loada and axacutas tha OSS 

C/65 ccxnpllar 

ua «rii C/63 ownars only 

uaagei C65 aourca-fila daatinatlon-fila C-Tl 

argumentai two fila apaclflara 

Option» -T lnclude C/65 aourca Text in 

• aaaemblar output 


Deacription» 

Thia command loada and axacutas tha fila C65.COM, tha 
OSS small-C complller. Two filanamea ara requlred. 
Tha flrat fila given must ba tha name of a text fil« 
contalnlng C/65 aourca code and Statements. Tha second 
flla apaclflad will ba created (or rauaed. If it 
alraady axiats), and tha coopilar will writa 
HAC/65-compatibla aasembly languaga to it. 

Option 

If tha -T Option ia apaclflad, tha HAC/65 fila will 
contain tha uaar'a C/65 taxt linea. Each aourca lina 
pracedea tha aaaembly coda it ganaratea, if any. 


• •• FOR MORE INFORMATION, SEE YOOR C/65 MANUAL •** 

*** YOU MUST PURCHASE C/65 SEPARATELY -- IT IS HOT 
SUPPLIED AS A STANDARD PART OF DOS XL ** 
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6.2 CLRDSK 


commandi CLRDSK 

purpoaat To initialise i dlrtttt« lika tha Atari 

813 dlak driva doaa. 

uaarat Kon-Atari dlak driva uaars 

uaagai CLRDSK 

argumentai nona 

optional nona 


Deacriptlont 

Thia Utility ia uaed to force your non-Atari diak 
driva to initiaiiza a diakette juat lika tho Atari B10 
diak driva doea. Hopefully any progran that doea not 
work with a diaketta initiaiised in your non-Atari 
diak driva will work aftar you inltialiaa tha diakatta 
uaing tha CLRDSK Utility. 

KOTEi CLRDSK formata tho diakatta firat, thon writea 
xeroea to all aactora axacpt tha directory, boot and 
VTOC aactora. , 

HOTEi In gonoral, do NOT uao CLRDSK unlaaa inatructad 
to do ao by your driva'a manufacturer. If CLRDSK doea 
not appear on your maatar diak, it ia not naceaeary 
for proper Operation o£ tha drive(a) you hava bought. 
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6.3 config 


commandt 


purpoaat 


argumenta i 


optiona i 


Deacription 


CONFIG 

Aliowa tha uaar to changa tha ntatua of 
a configurabla driva 

ownara of configurabla drivaa 

CONFIG Cparml parrnl ...1 f-Mj 

an optional liat of paramatara which 
dafina tha daaired atatua of drivaa in 
tha ayatem 

-K no driva configuration tabla* 

will ba dlaplayad 


If no paramatara ara glvan, thia command almply raporta 
tha atatua of all drivaa currantly attachad to tha 
Atari computar. 

Xf ona or giora paramatara ara givan, they ara praaumed 
to ba rcquaata to configurabla diak drivaa to configura 
thcmaelvaa. A parameter conalata of a alngle numaric 
digit (in tha ranga of 1 to 8) foliowed by ona or two 
alpha charactera (tha "Mode“). Tha digit ia praaumed 
to ba a dlak driva numbar (corraaponding to Dli through 
D8t). Tha legal character combinationa uaabla aa Mod»« 
ara aa followai 


Heanlng 


Configura thia driva aa a Single density, 
aingla aided driva. 

Configura thia driva aa a Double denalty, 
aingla aided driva. 

Configura thia driva aa a Double denalty, 
Double aided driva. 


a Double denalty. 


Optiona 


Normally, tha CONFIG command will liat out tha currant 
driva configuration. Uaing tha -N Option will cauaa 
thia tabla to ba omlttad. 

NOTEt DOS XL veraion 2 can NOT accaaa tha aacond .aide 
of double aided diak drivaa ("DD"). Inquire about DOS 
XL varaion 4 if you hava auch drivaa. 
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Section 6.) (COW^iq Continued) 


liu^Ul 

COUfiq ip 3DD 

raqueata that Dli be conflgurad ac doubl* 
danalty, fingt* ald*d ( vhil« 03t will 
pacoat« doubl« danalty, doubl* plded' 

•WOTESi 

If a configuration raquaat la madf, tha (11* managar 
ayata* if ralnltialited and th* ayatam «tatua la 
raported, af If (ha couund COtlYiq vlth no papamatar* 
had baan givan. 

If a confIguration raquaat la Invalid (f.g., if tha 
drlva 1* not capabla of balng conflgurad yia-foftwara), 
tha conutand will faport an arror. 




«.4 COPY 


COmaandi COPY 

purpoaat Thia program coplea fllaa. Hota tha 

cautlona llatad balow. 

uaagat COPY aourca-fiia daatination-f11* C-YQSM] 

or 

COPY flla [-PQSW3 

arguaantat ona or two flla apacifiara 

optional -F forca ovarwrlta of aaiating flla 

* -0 query befora aach flla tranafar 

-S alngl* diak copy 

-W wait for uaar raaponaa bafora 

copying 


Daacriptlon 

Tha copy program coplea ona or aor* fllaa without 
changing tha aourca flla. In th* flrat form, all fllaa 
aiatching tha aource-fila apeclfier would ba copied to 
fllaa indicatcd by tha deatlnation apeclfier, which may 
be on tha aame or • a different dltk. In tha aecond 
form, tha fllaa indicated by tha flla nama would be 
coplad to fllaa having tha aama nama on tha aame drlva, 
Thla anablea tha copying of fllaa on a aingla diak 
ayatem. The aourca and deatlnation flla apacifiara 
ahould b* of on* of th* followlng formal 

1) CDmIfila-name 
3) Dm 

In form 1, th* drlva apeclfier (Dm) la optionall tha 
currant dafault drlva will b* aaauaed if no drlva 
apecifiar la given. In th« aecond form, all fllaa fron 
tha lndicatad drlva would ba copied to or frcxa another 
dlak. 

Option* 

Th* -P option cauaea. tha ' program to ovarwrlta an 
axiating flla if it haa th« aame nama aa a deatlnation 
flla to ba copied. If thia Option la not apecified, 
filea whoaa deatlnation naraea already axiat will not b* 
copiad. 

Tha -0 Option cauaea th# program to aak th« uaar 
whethar to copy «ach flla. 
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Section 6.4 (COPY continued) 


The -S Option indicates to tho program that it must 
porform the copy on a single drive. Copy will prompt 
the uaer to Insert source and destinatlon disk« at the 
proper time. 

The -W Option indicates that the program must weit for 
the ussr to Insert the proper diska befora inltiating 
the copy. 

CAUTIOH« 

Do KOT uae COPY to copy fron a single density dlskette 
to a double dlskette on a single drive. Xnstead, uae 
6 DCOPY (section 6.13). 

Examplea« 

COPY *.* 

will copy all flies on the current disk on the 
current drive to another disk on the sang 
drive. The syatem will prompt the uaer when 
the dlskette needs to be swapped. Generally, 
DUPDSK is a more effective and faater means of 
performing thia function. 

COPY *.COM D3i -r 

will copy all files having- an cxtension df 
*.COH“ fron the current disk drive to drive 3 
(which could be the aama as the current drivei 
caution). If the file(s) already exist on 
drive 3, they will be eraaed and rewrittsn. 

COpY D2 «C*.* Dli -Q 

will ask the uaer if he wanta to copy each file 
atarting 'with the latter *C* frot» drive 2 to 
drive 1. 

COPY Dl «TEST D2 «HEWTEST 

will copy the file TEST On drive 1 to the file 
HEWTEST on drive 2. 

COPY Dl «TEST Dl «HEWTEST -S 

will perform a single disk copy of TEST to 
HEWTEST. 
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command« DO 


purpoae« Thia command «llowa the uaer to parforat 

aaveral Operation« with on« cosimand lin« 

usaga« DO coeunandClcosunandjcommand. .*} 

or 

DO 

argumenta« optionally. a llst of commanda aeparated 

by aemi-coiona 

optional non« 


Dascription 

This DO comaand allowa the uaer to isaue aaveral 
commanda on one lins. These commanda ara not 
restricted to DOS XL lntrinaic and axtrinaic commands, 
however. Por axampl«. tha foiiowing DO coamand wouid 
actlvate the aasemblar/editor Cartridge or OS8 MAC/65, 
enter a aourca program, and aeeembl« 1t» 

DO CARI EUTER "DlPROGRAM.ASM*IASM , |P< , ID «OBJECT 


In the aecond form of the DO conungnd, tha DO program 
will prompt the uaer for a iist of commands, on« at a 
time, saving these away for usa. Th« «ntry of just « 
carrlage return whsn promptsd for a command will caue« 
the «ntlre llat of commands to be exacuted. 

Th« DO command may also b« ussd to run a BASIC program 
upon booting th« systsm («imtlec to the AUTORUH.SYS 
function of Atari DOS) by placing « DO command wlthln 
th« STARTUP.EXC fil« (««« chaptsr * on batch 
procssslng). for «xampl«, placing th« foiiowing within 
th« STARTUP.EXC fii« will caue« tha BASIC program 
“MENU* to b« run upon booting th« ayatem« 

DO CAR«RUH *D1«MEHU" 

HOTE« some program« which inspect th« DOS • XL command 
lins th«maaive« cannot b« used with DO. CP'« COPY 
ccmmand ie an exampl« of such a program. 
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6.6 DUfDBL 


commandf OUpDBl* 

purpoMi Thi» program proyida« faat copyfng 

? urpo.,, JgiaJlSTSapitf diakette, 

uaarai OMLY fhoae uafng double danffty diaka 

uaagai * pUPDBL 

argumentai nona 

optional nona 

Daacfiption 

Tha DUPDBL program will prompt tha uaar for aourca and 
deatlnatlon drivaa. and will aak whather to formet tha 
deatination dlak. Tha antira aourpa dlak will khin » 
coplad to tha deatination dlak in a mannef aomewhat 
faatar than tha copy utiiity wouid provida. Tha two 
diaka, howaver, MUST ba doubla danaity 08/A+ 
formattad undar yaraion 2 of DOS XI, (or htafi DOS .2.03 
aa patched for doubl# denalfy). I? tha deatination 
driva ia tha aama aa tha aourca d*}*«. tha program will 
prompt th# paar to awap diaka durin^ tha duplication 
proce««. 

See alao jectlona 7.3 and 7.-« for mixed denfity coplaa. 


8,7 DUPDSK 


DUPDSK 

Thia program providaa faat copying of 
antira floppy diaka of tha aama alte and 

typ* 

all EXCEPT thoaa uaing doubla danaity 
uaagai DUPDSK 

argumentai nona 

optional nona 

Deacription 

Tha DUPDSK program will prompt tha uaar for aourca and 
daatination drivaa, and will aak whathar to formet tha 
deatination dlak. The antira aourca diak wiU than ba 
copled to tha deatination diak in a manner aomewhat 
fester than tha copy Utility wouid provida. Tha two 
diaka, howovar, must ba of tha aama alte and type. If 
tha daatination driva la tha aama aa tha aourca driva, 
tho program will prompt tha uaar to awap diaka during 
tha duplication proceaa. 


CAUTIQUi Do MOT attampt to uaa DUPDSK to dupllcata 
doubla danaity diakattea undar varaion 2 of DOS XL. 
Unpredictabla and disaatroua raaulta may oceurl DO uaa 
DUPDBL (aaa pravioua aaction) for thia purpoae. 

See alao aactions 7.3 and 7.4 for mixed danaity coplaa. 


eommandt 
purpoaet 
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6.8 IMIT 


INIT 

Thia program initializea floppy diaka 
■o that they »ay b« read from 
or written to 

INIT 

argumentai nono• 

optional nono 


Deacription 

The INIT utility allowa the uaer to formst a floppy 
diak ao that it »ay be read or written by prograraa. 
Under DOS XL veraion 2, the uaer will be prorapted for 
Information on exactly how to initlallze the diak 
(i.e., with or without a ayatem file, etc.). When the 
Initialisation proceaa ia complete, the floppy die* 
may now be uaed to etore data. 1 

The INIT utility preaente you with 4 optional 

1. Format Diak Only 

2. Format Diak and write DOS.SYS 

3. Write DOS.SYS only . 

4. Exit to DOS XL , * 

CAUTIONi If ueing DOS XL with elther a SuperCartridge 
or an Atari XL-aeriea Computer, you »ay not uae 
optiona 2 or 3 to write DOS.SYS to the dlak. You ouat 
uae COPY to add both DOS.SYS and DQSXL.SYS if you wiah 
to »ake a bootable DOS XL diek. (A diak with DOS.SYS 
alone will boot. but will not take advantage of the 
extra memory availablo in theae configurationa.J If 
the ayatem waa bootad from a waater diak which did not 
hava the file DOSXL.SYS, then optiona 2 and 3 are aafe 
to uae. See alao aectione 3.7 and 7.7. 


cotnaandt 

purpoaet 

uaagei 


6.9 INITDBL 


conunandi INITDBL 

purpoaet Thia utility ia uaed to lnitialise a 

double denalty dlakette ao that they can 
be read from and writtan to in double 
denalty. 

uaerai DOS XL veraion 2 uaara with a aingla 

non-Atari diak driva. 

* 

uaage INITDBL 

argumentai . none 
optional * none 


Deacriptioni 

NOTEi The’INITDBL utility ia unneceaaary for uaara with 
»ore than one diak driva. Inatead, juet uae the 
etandard INIT utility (aee aection 6.8). 

The utility INITDBL ia to ba uaed on a one driva ayatem 
to Initlallze a double denalty diaketta and write 
DOS.SYS to it. 

To uae thia utility, boot the maater dlakette. Type 
the INITDBL command, and anawer the prompt with the 
number 1. Befora you type CRETURN). replace the maater 
diaketta with your new unformattcd double denalty 
dlakette. When the INITDBL utility le finiahed the 
diak driva will atill be conflgured aingla denalty. To 
get a dlrectory of your new double denalty dlakette, 
CONPICure the diak driva to double denalty and typ« the 
DIR command. 
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6.10. MAC6S 


HAC6S 

Load» and «x«cut«f th« HAC/63 ucro 
«faembler 

HAC/65 diak owner» anly 

KAC65 cm«l [fil«J [*il«3 J } C-A][-0] 1 

an optional aut of on« to thraa filanama, 
conatrued to ba tha sourca, liating, and 
Object fllea (respactIvelyj of a MAC/65 
aaaembly. 

optional -A aource fil« ls Aacll 

rP aaaembly muat b« piak-to-Diak 


Oeacriptioni 

Thl« conunand loada and «xecutea tha (11a MAC6S.COM, tha 
OSS Macro Aaaembler/Editor. If no filanamea ara glven, 
MAC/65 will ba invoked in ita intaractlva (Editor) 
mode. Programa or text may th«n ba adlted and/or 
asaembled. See tha MAC/65 manual fo r furthar detail«. 

If one or mora filea are apeciflcd, • MAC/65 will b« 
invoked in ita "batch“ mode. That la, It »»411 par(onn 
a aingla aaaembly and then return to OS/A*. Genarally, 
this conunand iina will perform th« asaambly in a manner 
äquivalent to giving tha “ASM" corwr.and frora th« MAC/65 
Editor. That i«; if oniy ona filanama ia glvan, 1t la 
aaaumed to ba the aource flie, limplying that tha 
liating will go to the acreen and tha object coda will 
ba placed in memory (but only if requaatad by th« .OPT 
OBJ diractlva). If a aecond filanama ia givan, it la 
aaaumed to ba tha nama of tha liating fil«. Only if 
all thraa filenamaa ar« givan will th« Object cod* ba 
directed to th« fiie apacifled. 

NOTE■ if an aaaembly neada no liating but doea need an 
object fil«, the uaer may «pecify Ei aa th« liating 
fil«, thua aendlng th« liating to th« acraen. 


conunand« 

purpoa«« 

uaara« 

u«agai 
argumant«i 
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Saction 6.18 (MAC65 contlnu.d) 


Optiona 

Th. -A option ia uaed to «p.cify th«t th« aourc« fil. 

«h. ’JJJ;; 2i; Är,“ 

«equenc« of command« "ENTERIC.* «nd “ASM th * 

remember, even if th« «ourc^u 1419 ? programa. (And 
tabl«a muat reaid« i. ,ourc “ flta, tha macro and aymbol 
muat reaid« in memory during aaaembly alao.) 

™ ”' d *» «~i»>«i~ «m, 

opcio[i uiü iSÄolfL?“ ■“ 


*** fPR M0RE INF0RMATI 0«, SEE YOÜR MAC/65 MANUAL *** 

5f °ei.Dor S T«-^ URCHASE MAC/6S SEPARATELY — IT IS NOT 
SUPPLIED AS A STANDARD PART OF DOS XL ••• - 







6.11 MENU 


command« MENU 


purpos«i 

usaga« 

argumenta« 
optionai 
Descrlptlon 


Thla program providea a MENU of ayatem 
coramanda to help tha beginning uaer. 

MENU 

none 

non« 


r* f f rmly belleve that the command ayatem of 
aSnrJ^H C ° nsoU Proceaaor (CP) ia auperior to a menu 

flexibintv^Fr" I* * y underatand how the wealth of 
flextbility offered may overwhelra the new uaer 

DrovM° re ' W * hava P rovlded thia MENU command which 
command*. m6nU — a “» moat freguently,ua«d ay^ 


me " u ' aimply type HENU (followed by a 
pr °- pt ,pp "" 

Refer to Sectlon 3 for detalla on ualng th« DOS XL MENU. 



6.12 RS232 


command> RS232 

purpoa«« inatalla th« aarlal d«vlc« handl«ra 

» Rm") for ua« wlth th« Atari 853 
fntarfac« Modul«. 

ua«rai 

uaagei 
argumentai 
optionai 


DeacrIptlom 

Ualng th« command RS232 fron DOS XL la functlonally 
•gulvalent to ualng Atari 1 « AUTORUN.SYS ftl« (which 

a R J h4 '’ dlora »t pow«r or> tim« under Atari 
DOS). Th« drlvar for th« varlou« RS232 function« la 
load.d at LOMEM, LOMEM la movad, and th« Rt d«vlc« la 
hookttd into th« handl«r tabi«. * 

Aft«r glvlng th« RS232 command. if th« Dn. prompt 

® ELOW th# iin * contalnlng th« *RS232* 

properly h^* rfac * " odlii * haa loadad lta ««tw.r« 

Y ’ le ‘ howov * r > th« acr««n clear« «nd th« Dm 

vrono durlna* !£ T? P ° f th * * cc * en ‘ •‘»«hing w.„t 
«oftLre li r‘ l ° 4dln 9 Ptocea«. Unfortunat.ly. th« 
«able «iror I " t ‘ rfaco Hodul. doea not r.turn • 

cod «. prefarring Inatead to do a ayatam 
warm*tart (h.nc« th. claar.d acr«.n). * 

Intlrfac.^od 1 ? * w?“ 3 . in th# tottv * r * in th« 850 
UMIX ooin??r ‘ „ittIng RESET will d.atroy th« prop.r 

bTth, RS232 £:«df iV e * ignorl "f th * *P 4C « occupl^l 
ti* tl thU pröüu"'* S “ A ^ ndl * »*« a poaalbl« 

l^tlllie.nt* ? 50 f ntarfac « Modul« 1. aom«tlaaa too 
lnt«lilg«at for it* own good« In particuUr onA 

wtthout 3 tur r ? Uy ^ lOSd th * ‘ 0ft ““« thU ^dSu 

wlthout turnlng th« modul« off and back on «galn. 









6.13 SDCOPY 


command« 

socopy 

purpoae« 

Thia program ls uaad to copy single 
density files to doubls denaltyftles. 

uaera« 

Afari ownera uain^ OS/A+ varaion 2 only. 

uaage« 

SDCOPY sourco-file dastination-file C-fQRV] 

argumenta« 

one of two file apecifers 

optiona« 

-F force overwrite of existlng file 

-Q query before each file transfer 

-R reverae Orientation of copy 

-V verboae 


Oescriptlom * 

Tha Utility SDCOPT is {or OOS XL Varaion 2 ownera with 
non-Atari «Hak dpivea only. The purpoae of thia 
utllity is to copy a single denalty toure« flie to a 
double denalty deatlnation file. Thia Utility Works 
Option* 1 "* V4y 41 th? C ° Plf util *ty «xeept for the -R 

Tha -R Option is uaad to reverae the Orientation of the 
copy. That ia instead of copylng from a single density 
aource file fo a double denalty deatlnation, tha 
Orientation ia pevarsed and the copy goea front a double 
denalty yourc« file to a single density deatlnation 
file. " . 

KOTE» the SDCOPY Utility can only be used with one diak 
drive. If you want to copy front single density to 
double density between two different drlves. Just uae 
the CONFId command to set the drlves up properly and 
uae the normal COPY utllity. " ' . . * 


Exampleat 

socopy *.• -Q 

will copy all the ffles on the current 
single density diakette to a double 
denalty diakette in the same drive 
8DC0PY ABC OEP -R 

Will copy double denalty file “ABC* to 
the single denalty diakette ln thia 
•«ia drive. The copied file will be 
naraed *DEP* on the single denalty diak; 
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Section 7» MULTIPLE DRIVES, MULTIPLE DENSITIES 


Much--but not all—of the material you have read up 
until now aaaumea or impliea that you have only a single 
diak drive. While DOS XL can function perfectly well on 
a single drive, it really begins to ahow its power when 
you connect two or mors diak drlves to your Atari 
Computer* 

If you have only Atari B10 diak drlves. Vary little 
needs to be aaid about uaing thera to advantage. 
Generally, you will find that DOS XL will perform 
operations auch aa COPY (menu Option C) and DUPDSK (menu 
°'2,. mu< : 1 ? faater 1* You apecify that your •aource* 

(the file or diak you are copying from) ia on one drive 
and your "deatlnation’ (the diakette to receiv« the 
copied material) ia on the other drive. 


It does KOT matter which drive is the aource and which 


» - , . -- «KM «IIAbli 

ia the deatlnation. But be aware that many DOS XL 
canraanda require that a System master diskette be 
installed in drive 1 (or the "default drive" at 
least—aee aection 5.3 if you are not uaing the menu). 


Thia is NOT a limitation. 


since all Utilities which need 


to be loaded from the System master either wait for you 
to give a response before executing (e.g., IHIT) or 
allow you to apecify that you want auch a wait (e.g.. 


the "-W" Option of COPY). (And note that these wait 


options are always automatically chosen for you when you 
uae a menu Option.) 1 


If you have a non-Atari drive, wo would auggest you read 
the rest of thia aection. 


Ma ?5f , the procedurea diacuased in the aubaections 
which follow require the use of commands and options 
which are NOT available from the “ordinary" DOS XL menu 
level. You, as the uaer, have two ways of uaing these 
commands; First, you may uae the ."X" (Xtended command) 
menu Option. When you use "X", DOS XL prompts you for a 
command 1 ine. At that time, type in the command aa 
ahown in the deacriptiona below. Second, you may use 
tha CP levei of DOS XL (possibly by choosing Option "Q** 
from the menu). Again, aimply type ln the command as 
ahown below when you are proropted by "Dli". 


I Remember, when using the CP commands CONFIG, | 
I INITDBL, INIT, COPY, and SDCOPY, aa described below, | 
you MUST have a DOS XL master diakette in drive l I 
I when you type the command. If you da not, you will I 
I get a FILE HOT FQUND error mesaage. f 
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7.1 Setting Up Multiple Drives 


DOS XL Version 2 is compatible with and capable of 
Controlling any raixture of up to eight single density 
and/or double density diak drives. If you hava a drive 
capable of double density Operation a« well as one or 
»oro drives only capable of single density, va vould 
suggeat that you connect tbe double density drive as 
drive 1 (see your drive manufacturer's manual for switch 
settings, etc.). This will allow you to boot DOS XL in 
cither single or double density mode. 

If a drive ia capable of either single or double density 
Operation, you can generally predlct what state it will 
be in when power is turned on. Xf it ia drive 1, it 
will acquire the density of the booted master disk. Xf 
it is other than drive 1, it will adopt its density frora 
the switch setting on the drive’s Controller (again, see 
your drive manufacturer's manual). Of course, if it is 
not capable of double density Operation (e.g., an Atari 
810 Disk Drive), it will always be single density. 

DOS XL as shipped ia set up to handle 1 or 2 disk drives 
and up to 3 simultaneously open filea in double density 
mode (i.e., 3 BASIC "OPEN* atatenanta without an 
intervening "CLOSE”). If you own 3 or more disk drives, 
or you require more filea open at one time, you must 
change the values in certain System variables. See 
section 7.5 for more Information. 

DOS XL automatically asks each drive what density it is 
when the boot process occurs. From then on, if you want 
to change a drive's density, you must use the CONFIG 
command from DOS XL's Command Processor. 

CONFIG has several optlons, and you may read section 6.3 
of this manual for more Information on its capabilities. 
For our purposes, however, we need to learn three of its 
abilities before going on. Remember, the following 
coramands MUST be performed from CP or via the X menu 
Option. 

1. If you wish to find out what density DOS XL believes 
each drive ia, wait until you are prompted as above. 

You type« CONFICJ [RETURN] 

The table which is prlnted will teil you what 
density each disk drive is as well as how many sides 
DOS XL ia acceasing (always 1 side with Version 2). 
If a drive is not capable of double density 
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Operation, it ia noted as *can*t configurs*. Up to 
eight drives will be reported, and the System will 
even teil you which drives you don't have. CAUTIONs 
the fact that CONFIG reports a drive as present does 
NOT imply that it ia accesaible to DOS. See section 
7.5 for mors on this subject. 

m 

2. If you wish to change a drive from single to double 
density, wait until you are prompted as above. 

You Type« CONFIG ID [RETURN] 
or * 

CONFIG 2D [RETURN] 
etc. 

Here, you speclfy the drive NUHBER you want to 

configurs and than use a *D* to indicate Double 
density. Any configurable drive may be changed this 
way. The coroplete CONFIG table will be displayed. 

3. If you wish to change a drive from double to single 
density, wait until you are prompted as above. 

You Type« CONFIG IS [RETURN] 
or 

CONFIG 2S [RETURN] 
etc. 

Here, you specify the drive NUMBER you want to 

configurs and then use an "S* to indicate Single 
density. Any configurable drive may be changed this 
way. The complete CONFIG table will *>« displayed. 


CAUTION« Whenever you dupllcate diskettes using more I 
drlve « whether using the "D* menu Option or I 
DUPDSK or DUPDBL, you MUST be sure that both drives 
I CONFIGured to the aase densityt You may use 

CONFIG (as in 1., above) to check that both drives 
I are the sams density and/or change them to be the 
same. See sections 7.3 and 7.4. below. for 
I Information on cross-density transfers. 








7-2 Inltializing Other Densitlea 


He noted ip aection 3.7 £hat you ahould only uae the *1" 
menu Option to initialize a disk which i» the aame 
denaity aa the booted master diak. Uslng the extended 
optlona of DOS XL, however, thore »re feveralother 
possibllitles. And there is one exceptlon to 7 . 7 , also. 

1. If you h*ve « single drive ayatem, you aiay 

initialize a double denaity diakette even if you 
have booted a aingle den«)ty maater. To (lo f Q, when 
you are prompted aa above, • 

You Type« mifOBL [return] 

INITDBL Is a command whtch, when it haa loaded from 
the pos XL maater diak, will almpiyaek you which 
drive you wiah to.use (presumably 1, ln thia case). 
It will then automatically configure the drive to 
double denaity, formet the diskette, write DOS.SYS 
to the diskette, and then reconflgure the drive back- 
to single denaity. DO HOT uae thia command when you 
have booted a double denaity mastäf diak. Uae INIT 
or menu Option *1" instead. 

2. If you have a multiple drive ayatem, you may uae 
CONFIG to configure drive 2 (or 7 or eny other 
drive) to the denaity you dealre.' You may then wait 
for appropriate prompt, and 

You Typet • INIT fRETURN] 

and the INIT Utility will load and run, preaenting 
choicey identical to those preaented by the "I" menu 
Option. (Or, at the menu prompt you may uae menu 
Option *I a .) The actual rule, simpllfied in aection 
3.7, ia that you may initialize any diakette to the 
denaity of the drive it ia placed ln. (And you may 
check or aet the denaity of a drive via CONPIG.) 


7.3 Copying Between Densitiea. Single Diak Syatem 


Thia aection appliea only to those with one drive and 
assumes that that one 'drive ls 'a configurable 
(aingle/double denaity) drive. If you have two or more 
drives, aee the next aection. 

If you would like to copy one or more filea frora a 
aingle denaity diakette to a double denaity diakette (or 
vice versa), you muat first have a diakette phlch haa 
been formatted (initialized) to the proper denaity. If 
you do not have such a diakette, we auggeat that you 
boot a maater diak of the proper denaity and uae the *1" 
Option to initialize a blank diak. (Or aee aection 7.2, 
above, for uae of INITDBL.) 

Then, after having used the *Q* Option of the menu, wait 
for the appropriate prompt, 

and You Type« SDCOPY *.* -Q CRETURN] 
or ' 

SDCOPY *.* -QR [RETURN] 

The firat form will copy filea from single to double 
denaity. The second form will copy filea from double to 
aingle denaity. 


SDCOPY will load in and then allow you to place your 
source (*from*) diakette (if it is not the maater diak) 
in the drive. SDCOPY will then read the filea directory 
of the source disk and givo you a Chance to aay Yea or 
No about each file in the directory. If you answer Yea, 
the file will be copied to your destination ("to") disk. 
Since you have only a aingle drive, you will have to 
awap diskettes at least once for'each file Jtlong filea 
may reguira two or three awaps). 


SUGGESTIONSt (1) Read aection 6.13 for other optlona 
available with SDCOPY. (2) Remove any Cartridges in 
your roachlne if you are copying large filea. They may 
copy in fewer awaps, since the Cartridge apace is used 


by SDCOPY. (Thia doea not apply to OSS SuperCartridges, 
which already automatically releaae thair space to DOS 
XL » ) 









7.4 Copying with Multiple Drives 


If you own 2 drives, you may instaad use the Standard 
“Copy Files" command (option *C" of tha manu) to 
transfer files between single and double density. 

First, however, you must ensure that your drives are 
appropriately conflgured. 

Since you preaumably have booted your double density 
master diakette on drive 1, we suggest that you use 
"CONFIG 2S" (see 7.1, above) to place drive 2 in single 
density mode (unneceasary, of coursa, if drive 2 is an 
Atari 810 Disk Drive, since it is always single 
density). 

Remember, to use COPY or menu Option "C" after using 
CONFIG, you must wait for the appropriate prompt. When 
asked for "from" and "to" file names (or when placing 
thera ln the command line for COPY), be sure and specify 
"Dl:" and *D2>", aa appropriate. (If you make a 
miatake, Copy will probably not find the file names you 
ar# looklng for, so no harm will be done. Just reverse 
the drive specifiers and try again.) 

SUGGESTION: The COPY command available from the DOS XL 
Command Processor is extremely flexible and powerful. 
It may be in your best interesta to learn its secrets 
even if you do not want to learn all about CP. (By the 
way, note that the menu command "C" invokes COPY with 
the -Q and -W optlona requested.) > 

I CAUTION: You may NOT use menu Option "D* (Duplicate I 
I diak) to copy from a double density to single I 
I density diakette or vice versa! Strange and I 
I diaastrous thingS will occur if you atteropt to do I 
I so. Similarly, you may not use the CP commands I 
| DUPDSK or DUPDBL for thia purpose. Duplicate disks j 
I are literally duplicate», including the fact that I 
I the densities MUST be the sarae. I 


7.5 Using 3 or roore drives 


DOS XL as shipped is eet up to handle 1 or 2 diak drives 
and up to 3 simultaneously open files in double density 
mode (i.e., 3 BASIC "OPEN" Statements wlthout an 
intervaning "CLOSE"). If you own 3 or »or« disk drive«, 
or you require more files open at one time, you must 
chang« th« valuea in tha syataoi vaciablai DRV2VT and 
8 ABYTE as followsi 

Changing the number of drives« As shipped. tha System 
variable DRVBYT, location 1802 decimal, holde the value 
3, which allows you to use 1 or 2 disk drives. If you 
need to Change this value, refer to the following table 
for new values: 

value« number of drives« 


1 

only 1 

3 

1 or 2 

7 

1 , 2, or 

15 

1 to 4 • 

31 

1 to 5 _ 

«1 

1 to 6 

127 

1 to 7 

255 

up to 8 


In Order to change the value ln DRVBYT, perform the 
following steps« 

1) Insert the Atari BASIC Cartridge into your 
Computer (do NOT use BASIC XL). Boot your 
DOS XL master disk. 

2) Ensure that the DOS XL menu is not active by 
issulng the "Quit to DOS XL“ command. 

3) Enter the BASIC Cartridge via the CAR command. 

4) POKE location 1802 with the deslred value. 

5) Hit the SYSTEM RESET key. 

6 ) laaue the “DOS“ command to raturn to DOS XL. 

7) Type« MENU CRETURN) to get back into the menu. 

8 ) Use the 'Initialixe Disk" command with Option 
3 to write DOS.SYS onto your master disk. 

Changing the number of simultaneously open files« As 
shipped, you may open at the «am« time up to 6 single 
density files, or up to 3 doubl« density files. If thia 
«etting is not enough for your appllcatlon. you may 
change the value ln the System variable SABYTE, location 
1801 decimal, according to the following table« 
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füM open ln fllM °P' n 1° 

single denaltyi doubl« i)«naltyi 


4 * 

6 3 

4 

* 

♦ 

In order to chang« tb« valu« li> 6ABYTB, parform th« 
follow(.ng «tapai 

J) Ipaart tho Atari BASIC cartrldga lnto your 
Computer (do NOT uaa BASIC XL). Boot your 
DOS*XL mastar dlak. 

2) Ensur« that tha DOS XL manu la not actlva by 
iaauing tho “Quit to DOS XL* command. 

J) Enter tha BASIC Cartridge via tha CAR command. 
41 poKE locatlon 1801 with tha daalrad valu«. 

51 Hit tha SYSTEM RESET kay. 

6 ] Issua tha "DOS" command to [«turn to POS XL. 

71 Typ«i MENU [RETURN] to gat back lnto tho menu. 
g) (Jaa tha “Initlallza Dlak“ command with Option 
3 to weit« DOS.SYS onto your maatar dlak. 

NOTEi You many chariga both SABYTE and DRVBYT (via POKEs1 
at atap 4. I? daalrad. thua «xacutln^ th« 8 «t«p« only 
onc«. 

Sea also Appandlx A for furthar Information on Juffer 
allocatlon, slzea, gtc. 

. . - •• ' i " t-s- ’■ ■ : ' ; ■ 


valuai 


2 

4 

6 

8 

18 

12 





7.6 Bootlng up dlractly lnto a BASIC program 


DOS XL ia capabla of bootlng directly lnto a BASIC 
program. In Order to do ao, you auat perforra a faw 
simple oparationa, vhich ara preaentad ln atep-by-step 
faahion belowt 

1} Boot a master diakette, antaring alther th« manu or 
tha command proceasor. 

2) If you want tha atartup flle on another dlak, place 
that dlak in tha drive at this time. If it ia not 
inltialized, refer to alther aection 3.7 (menul or 
6.10 (CP) for inatructiona on how to initializa it. 

31 Frora tha appropriate prompt (aea abova). uaa 

TYPE Et STARTUP.EXC [RETURN] 

At thla time, tha screen will b« blanked out and tha 
curaor will appaar in tha top laft hand corner of 
tha acreen. 

4) At thia time, type tha llne 

DO CAR>RUN*DiMENU* [RETURN] 

Note tha filename MENU ia a fictitious filename. 
Please replaca thia name with a nama of a program 
that ia on your disk. Also note that your BASIC 

f rogram must also have been SAVEd to tha disk before 
t can be uaed in thia atartup mode. 

5) Typ« tha characteri 
(cntl-3) 

To perform tho CNTL-3 function, press tho kay marked 
CTRL on tha left hand aide of tha keyboard while at 
th« aame tim« pressing down th« number 3 kay. (To 
tha Atari Computer*« OS, this Signals and 
«nd-of-file.) Vfhen thia Step has baan axecuted, tho 
fila STARTUP.EXC will actually bo writtan to tha 
disk and control will return to the operating System 
and the menu or Dli prompt. (For Information on the 
workings of EXC filas in general and STARTUP.EXC in 
particular, see Sections 8 and 9.) 
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6) In answar to the DIi prompt typ« DIR (or usa th« 
"f* manu Option) to obtaln a diractory of the disk. 
CAUTIONi if any of the dies 11sted below are NOT on 
your diskett«. th« STARTUP.EXC fil« will not work 
properly. 

dos. sys 

DO.COM • • 

STARTUP.EXC • 

your BASIC program fil« that was used in th« 
STARTUP.EXC die 

If DO.COM Is miss Ing, us COPV (C nanu Option) to 
move it frora your System master diskett« to thi« 
disk. If your BASIC program 1s mlsalng, SAVE it 
(frora BASIC) to this disk. 


7) Last but not least, before you try out this newly 
created diskett« by Switching th« power off and on, 
mak« sur« th« BASIC cartridga ls in it« proper 
siot. 
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7.7 Haking a Doubl« Den«lty Maater Di«k«tt« 

Thi« «ectlon presume. that you w.ra «*iPP« d • °° 3 ^ 
a sIno 1« density diskett«. only. Som« dl»* ariv« 
manufacturars ar« now shipping «lthar two disk« or « 
flip-ovar disk with a copy of DOS XL ln both slngl« and 
doubl, density. If you rec.lvad such a ‘«lsk. you do 

NOT n.ed ^is section. . Instead. simply boot th. 

density dealred and use nanu Option I (to initlalita 
a dl«k y of the appropriate density) or D (to-i?£) 1 If 
the master diskett« ln the^appropriat« density). If 
you u.a Option D. b. sur« to answ.r th« density 
question prompt correctly. (Of cour»., you * l *° 

US« DÜPDSK or DUPDBL command« from th* DOS XI« CP«1 

We provide her« step-by-step Instruction« for both menu 
mode and CP mode. In «ith.r case, we aasum. you hav. 
bootad a singl« density maater dlskatta. 

IcAUTIONi you should NOT us« your original master 
disk for the procedura we ar« about to 
( Be aura and use a duplicated copy of your 
| in.tead. Sine« we may r.name a fil«. Y°u raay NOT 
I hav« a writ« protect tab on the diak. Thi« 1« VERY 
I dangerous, hence the need for uslng only « copy of 
| your master di*K and MEVER th« original* 

From the DOS XL Menus 

I7' - Üäe'öpüönT''in.pect tha fil«. directory. Xf the 
filenarao DOSXL.SYS appears, uao the U Option, 

giving DOSXL.SYS as th« flleepec. and then uee tha 
R Option. To th« ’Old name* prompt, anewer 

DOSXL.SYS and to th« "New name" prompt. anewar 

eimply DOSXL. If you dld need to do thi« ranam«, 

• reboot your system at thi« tim« (turn your Computer 
power off and then on), 

2. Uee Option X. To th« “commandi* prompt, anewer 
1NITDBL [RETURN] 

When you are prompted wlth “DRIVE TO XNITIALIIfS . 
anewer wlth tha numeral 1 followed by 
Th« program will then prompt you to INSERT DISh 
•AND HIT RETURN“. At thi« time, remov« your ayatem 
master disketta and Insert a blank dlakatta. Than, 
and only then, hit [RETURN]. 
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INXTDBL takea a minute or ao to compiata ita work. 
Th« u.ual “HIT RETURH FOR MENU" prompt Vlll flnaliy 
occur, and voll «hould ralnaeft your maatar <?!***“• 
befor« [RETURN]. 

3 . Ua« Option X. To th« "command»“ prompt, fnawar 
SDCOPY ».* -0 

0 

Th« SDCOPY program will load and axacute. Khan it 
aaka you to innert tha dlak to b« copied, do 
nothing «xcapt hlt [RETURN] ainc« you will b« 
copyiof fchl# *y«tera jn«*»t.er di*K«tt«« 

SDCOPY will teil you whlch fil« you ar« about to 
copy and aak whether you wiah to do ao. If you hlt 
Y [RETURNl tha File will be copied. It you hlt N 
[RETURN], it will not b«. Preauming that you wlah 
a complate double denalty maater, the only fil« you 
do NOT wiah to copy ia DOS.SYS (aince INITDBL haa 
already wrlttan it to your new doubl« denalty 
dlaketta). Answer N to DOS.SYS but Y to all other 
fllea. (|f you KNOW you will not be ualng cartaln 
programa or fllea, you may anawar.N for them, alao, 
but we would «uggeat maklng af ’ laaat on« full 
double denalty maater.-) 

SDCOPY ia a alow and painful procea« of inaertlng 
and ramoving diakettea, but it will fipally finiah 
(and It ia worth it). 

4. Xf you uaed Option R ln atep l, above, uae Option 
R. He will now give DOSXL aa tha "old name and 
DOSXL.SYS aa the "naw name", thu« raatorlng the 
ayatem maater to ita original condition. 

5. Turn off the.power to tha Computer. Inaert your 
new doubl« denalty diakett« Into your drly«. Turn 
on tha Computer 1 « power. DOSXL «hould boot ln 
doubl« denalty mode. By obtalning a dlaketta 
directory (option P), you can not« whether DOS.SYS 
ia now only 23 aectora long. If «o, you hav« baen 
auccaaaful. 

6 . If you uaed Option R in atep l, abov«, uae Oftion R 
now. Again. w« will rename fron» "old name DOSXL 
to "new name* DOSXL.SYS, thu« «llowing «xtended 
■emory Operation the next time thi« diak ia booted. 

7. Label and wrlt« protect your new doubl« denalty 
■aatar. 
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Prom the DOS XL Command Proceaaor prompt (Oli) 


1. Uae the DIR command. If the fila DOSXL.SYS appeara 
in tha fila lletlng, UNProtect it and than RENama 
it to aimply DOSXL (with no axtenaion). Xf you 
ranamed DOSXL.SYS, reboot your ayatem. 

2. Uae tha INXTDBL command to inltialiae a blank 
dlaketta .in double denalty mode. Be aur« to 
re-ineert your maater diekatta when INXTDBL ia 
finiahed. 

3. Uea tha command 

SDCOPY *.* -Q 

to copy all filea except DOS.SYS from your aingla 
denalty maater to your new double denalty aiaater. 
Be aure to re-inaert your aingle denalty maater 
when SDCOPY i« finiahed. 

4. If you RENamed DOSXL ln atep 1, uaa RENama again to 
Change ita name back to DOSXL.SYS. 

5. Inaert your new double denalty master dlaketta and 
re-boot the Computer. Check to be aur« you do, 
lndeed, hav« a double denalty maater by uaing the 
DIR command. A double denalty DOS.SYS fil« ia only 
23 aectora long. 

6 . If you RENamed DOSXL in atep 1, uae RENama again to 
change ita name on thia double denalty dlaketta. 

7. Be eure to label and write protect your new double 
denalty maater dlaketta. 



Sactlon 8: THE DOS XL BOOT PROCESS 


Th« proceaa of loading the DOS XL operatlng ayatem into 
your Atari'a memory la aomewhat different than the 
proceaa for loading other DOS'a. Alao, deleting or 
edding cortain filea to a bootablo diak can affect what 
portiona of DOS XL are loaded. In Order for you to 
modify thie proceaa and thereby cuatomize your ayatem, 
thia aection deacribea the atepa which are foilowed in 
the boot proceaa. 


8.1 Extended Memory DOS Syatema and DOSXL.SYS 


Aa ahipped, your DOS XL maeter diakette containa two 
apecial filea. One ia called "DOSXL.XL" and the other 
ia called "DOSXL.SUP“. We ahall call theae two filea, 
collectively, the "extended memory DOS syatem(a)". 

In Order to take advantage of an extended memory DOS 
ayatem, you MUST have ona (or both) of the following« 

X. An Atari XL-aeries Computer with 64K Bytea 
of RAM (1200XL, 800XL, expanded 600XL, etc:) 
2. An OSS SuperCartridge (ACTIONl, BASIC XL, 
MAC/65, etc.) 

If you have neither of theae capabilitie«, pleaae akip 
to aection 8.2. 

Again, aa ahipped, theae extended memory DOS aystema are 
NOT active. If you wish to take advantage of poaaible 
extended memory configurationa on your Computer, you 
ahould read the reat of thia aection. Otherviae, you 
may akip to aection 8.2. 

If you are ueing an bSS SuperCartridge for moat of your 
work, you ahould rename DOSXL.SUP, following the 
procedura outiined- beiow. If you are not ualng 
SuperCartridge but you are ueing an XL-aeriea Computer, 
you ahould rename DOSXL.XL, again uaing the following 
proceaai 

If you are uaing the DOS XL MENU, chooae Option U. The 
"fileapec" to be unprotected ia either DOSXL.SUP or 
DOSXL.XL, depending on your ayatem configuration aa 
outiined above. Again, frora the menu, chooae Option R. 
In reaponae to the "Old naroe* prompt, anawer either 
DOSXL.SUP or DOSXL.XL, aa you did with the Option U 
prompt. In reaponae to the "New name" prompt, anawer 
DOSXL.SYS and return to the menu. 

i 
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If you are uaing CP, you ahould UNProtect DOSXL.XL or 
DOSXL.SUP, aa notad above, and then RENama that «am« 
fil« to DOSXL.SYS before proceeding. 

If you now reboot your ayatem (turn your coaputer'a 
power off and back on), an extended memory DOS ayatem 
will be bootad. 


How It Worka 


Khile moat DOS'a reaide only in the DOS.SYS fil« on a 
bootable.diak, DOS XL can actualiy occupy two aeparate 
filea. The firat file, DOS.SYS muat be on any diak to 
make it bootable. At the beginning of the boot proceaa, 
thia file ia loaded into memory, occupying iocationa 
5700 to 51E00. 

At that time, thia DOS (it ia actualiy a complete DOS in 
itaelf) checka to aee if the file named DOSXL.SYS ia on 
the booted diakette. If ao, DOS.SYS praaumea that 
DOSXL.SYS containa an extended memory DOS and loada it 
for you. Onco DOSXL geta controi, aeveral thinga 
happen. 

Eirat, DOSXL . checka to aee if you do, indeed, have tha 
memory configuration that you "claimed“ to hava when you 
renamed one of the DOSXL filea. If you do not actualiy 
have such a syitem, DOSXL returna controi to the 
original DOS.SYS and nothing »ore happena. For all 
intenta and purpoaea, DOSXL.SYS is not active at aill in 
thia circumstance. 

If, however, your memory configuration ia aa you 
"claimed“, DOSXL moves itaelf into the RAM memory 
"under" either the SuperCartridge or Atari'a OS (aa 
appropriate). 

This newly loaded Code now becomes the DOS of the 
machino. Thia DOS aavas the uaer 3K Bytea to 5K Byte« 
of memory by occupying memory which ia bank-ewitched 
with the SuperCartridge (by taking advantage of apecial 
hardwar« within the cartridg«) or tha Atari OS (again, 
by taking advantage of apecial hardwar« bullt into Atari 
XL~aeri«a Computers). 

Remerober, then, if you dealre NOT to load thie apecial 
DOS file, DOSXL.SYS, almply rename the file to a name 
other than DOSXL.SYS (we recommebd almply OOSXL, with no 
extansion) . 














B.2 Th« AUTO RUN • SYS fil« 


Düring th« boot proceaa, and onc« th« DOSXL.SYS fil« i« 
•ither ioaded, «klpped, or not uaed at all (•«« prpvloua 
«action), DOS XL »earchea th« dlek «or « fil« called 
AUTORUN.SYS (not« that thera i« no auch fil« on th« DOS 
XL maater di«k). Jf thl« Cil« l« found, U'-U Ioaded 
into memory juet aa l« you had lf«u«d • "Load Binary 
menu command. ‘ 

for exampia, on« way to lneura that the RS232 driver ia 
Ioaded Into memory «ach time you boot a cartain diak ia 
to renama tha fil« “RS232.COM" to tha narae "AUTORUN.SYS 
(aea aiao tha «action on tha «ila "RS232PIX.COM"). 

Thia loading o« AUTORUN.SYS ia compatible with tha Atari 
DOS mode o« Operation» ao moat AUTORUN.SYS lila* which 
ran with Atari DOS will «l«o run wit(\ POS XL. 


8.3 The STARTUP.EXC file 


Agaln, durlng th« boot proceaa, thera if yet anothar 
poaaible «l«p. 

If tha file AUTORUN.SYS ia not found, or if lt returna 
to DOS with a 6502 RTS inatruction. DOS XL «ontlnuea tha 
boot proceaa by «earching for tha fila STARTUP.EXC. 
Thia fil« ia a taxt file which contalna command« to th« 
DOS XL command proceaaor. 

On your DOS XL maater diak thera l« a STARTUP.EXC file 
which containa REM dommanda for juat putting meaaagaa to 
the acrean, and tjhe command MENU, which Ioaded and 
«tarted the DOS XL menu (aee the followlng «action for 
anothar method of loading th« manu). 

SIDELIQHTi Ir) Order to change the contanta of thl« -file, 
juat uaa the "Copy Filea* Option of the DOS XL mer.u and 
aelect “E<" and "DiSTARTUP.EXC" aa th« "frorn" and "To“ 
filea, reapectlwely. When the «craen claara and the 
curaor appeara at the uppar left of th« acrean, type th« 
dealred command«, one to a lina. When you er« finiahed, 
type controi-3 (hold down tha control key and preaa 3). 
Tha command« you typed will then be written out to tha 
diak Into th« STARTUP.EXC fil«. 

If you deaire not to have a STARTUP.EXC fila, aimpiy 
eraae it or renama it to a different name (perhapa 
STARTUP .TXT, for "text file“). 
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I Cartain cartridga-baaed producta, including ATARI | 
I WRITBR from Atari, Inc., will not work properly if | 
l your boot diak containa a STARTUP.EXC fil«. If you | 
are ualng a product auch aa ATARI WRITER, aak« a I 
I «pacial boot diak aa followai j 

j Dupiicate your maater diak onto a blank ona.| 

! 2) Eraae th« fil« STARTUP.EXC on that diak. | 

3) Eraaa th« file MENU.COM on that diak. | 

I I (only if you want more memory apac«) j 

You ahould now uaa thia diak for bootlng into ATARI | 
WRITER (you may uaa thia diak for booting into other I 
I productf. but you will not hav« th« menu if you go I 
t to DÖS). I 


8.4 The MENU.COM fil« 


A« the laat atep of the DOS XL boot proceaa, and 
preauming that neither AUTORUN.SYS nor STARTUP.EXC ha« 
taken control of the ayatam, one further action may be 
performed. 

The final atep of the boot proceaa ia th« loading of the 
DOS XL menu. DOS XL will aearch the diak for tha file 
KENU.COM. If that fila ia found, lt ia Ioaded into 
memory in the lowest avallable addreaa (the current 
valua of tha MEMLO polnter, locationa J2E7 and $2EB) and 
will be ln control at the end of th« boot proceaa. If 
the file MENU.COM ia not found, the DOS XL command 
proceaa will be ln control. 

At thia point. If there ia a Cartridge inaarted, it will 
be entered. Otherwiae, the DOS XL menu or th« DOS XL 
coromahd proceaaor, depending on which haa control of th« 
aystem, will be «ntered. 
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Section 9i Batch Processing 


9.1 An OverView of Batch Processing 


You may often find yourself repeating tha sarae group of 
commands over and over. DOS XL allows you to put theae 
cocnmands into a file with special capabilities. This 
file may be used by typing a single command which will 
cause all the conunands in that file to be executed. 
This can save quite a bit of your time and energy since 
you won't constantly be typing the saae string of 
conunands. 

Let's suppose that you wrote a set of ACTIONI programs 
that had to be run in sequence. You could do this in 
two waya» 

1. Isaue the CP extrinoic command for each program 
one at a time. If the running time of the 
programs was very long you might sit at the key 
board for hours just to type a program*name «very 
once in awhile. 

OR 

2. Create a BATCH file containing the DOS XL 
commands required to run the set of programs. You 
would then enter one command that would free you 
from the keyboard for more important (or fun) 
things. 

The second method is obviously preferable as it is 
quicker and can be repeated eaally. 

Any text file with the filename extenaion .EXC can be 
used as a DOS XL batch execute file. The execution of 
the file is invoked such like the extrinsic commands, 
except the command is preceeded with a commercial “at* 
Symbol (”#*). To execute the EXECUTE file DEMO.EXC on 
the Dli default device, typet 

DlteDEMO 


CP will open the file spec DliDEMO.EXC for input and 
then set up DOS XL to read it lins by.line, executing 
the CP commands just as if they were being entered from 
the keyboard. 
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An execute file is siraply a text file. Each line of 
this text file will become a CP command whan executed. 

The three basic rulcs of the text file linea aret 

1} they must contain valid OOS XL Console Processor 
commands 

2 ) they muat be shorter than 128 charactars in 
length 

3) they must and in a carrlage return 
(ATASC1X 598). 

OOS XL allows the commands ln an execute file to be 
preceeded by numbers and blanka. This feature allows 
the command linea to be numbered for readabllity and to 
document their purpoaea. 

The command file linear LOAD OBJ.TEST «return» 

and . 

103 LOAD OBJ.TEST «return» 

* re the aame to DOS XL. The CP scana the line for the 
first non-nuraerlc, non-blank character befors starting 
to scan the command word. Virtually any text editor, 
including the editor of MAC/65, can be used to create 
and modlfy execute flies. 

NOTEi One may also create an execute file (or, for that 
matter, any text file) by using “TYP El «diskfile»*. 
(TYPE will clear the screen, at which time you simply 
type in your text, line by line. You tcrminate the 
copy by pressing CTRL-3 on the Atari, the end of file 
Signal for the Ei device.) 


9.3 Intrinslc Commands for .EXC Files 


DOS XL has four special intrinslc commands dasigned for 
use exclusively with axacute flies. These commands 
arei 

REMARK Remark or comment (does nothing) 

SCREEN Turn on Echo of axecuta fila 

command linea tp the screen. 
(Default mode) 

NOSCREEN Turn off Echo of execute fila 

command linea 

CND Stop executing the execute file 

and return DOS XL to keyboard 
entry mode (the CP). 

See Section 3 for more detailed explanatione. 













9.4 Stopping Ratcb fij.es 


While an axacuta UU i* b*in9 proc««se4. varlou« 
condition* may occur yhich will warrant a halt in the 
batch exacution. These conditione may occur becaus* of 
aystem-datectad errop* or becau»* 'of a uaep program 
detacting a condition it conaider* Ijazardou* tp the 
aystam's Health. -iS-'li . 

9.4.V Stop* by DOS XL 

Humana are not quita perfect ln the ayaa of Computer* 
and aomatimea make pilstakes. DOS XL command* apeclfied 
in error will generate error maaaaga*. If DOS XL 
dlscover* pn error while executing an EXECUTE flle, it 
will print the error meaeaga aa uaual and STOP 
executing the EXECUTE flle. Note that thi« error atop 
only occur* if the error i» found by DOS XL, not )u*t 
becau** a program generatea an error. 

Executlon of an execute flle will also stop'after the 
CARTRIDGE commmand ia executed. 

Finally, executlon of courae *top* when the and of the 
exec.ute flle ia reached. i 

9.4.2 Stop* by U*ar Program* 

It ia aomatimea deairable for a program in a Chain of 
executing programa to stop the execut* proc*s*. The 
U3ual reaaon for thla ia that the program haa detected 
an error severe enough to invalidste the proceaees 
perforraed by the following prograra(a). The contlnued 
executlon of the execute file* ia providad for by a 
single byte flag wlthln DOS XL. If a program aeta thla 
byte to cero, then üpon returning to DOS XL the execute 
file executlon will imraediately atop. The execut* flag 
ia located 12 bytes from the atart of DOS XL, whlch ia 
pointed to by memory location 10 ($0Al. The following 
BASIC program aegment will turn off the execut* file 
and return to DOS XL. 

1000 CPADR - PEEK(ll)*256 PEEK (10) 

1010 EXCFLG - CPADR + 11 

1020 POKE EXCFLG,0 

1030 DÖS . 

Or, from BASIC XL, you could aimply uaa 

100 Poke Dpeek(10)+ll,0 i Do* 

(Remember, though, that a CAR comroand automatlcally 
stops EXC flle exacution, so thla axampl* may not be 
useful from BASIC.) 






9.S STARTUP.EXCx A Special File 


Th* execute filename STARTUP.EXC haa apecial »eanlnga 
in the DOS XL system. When the ayatera ia first booted 
(power up), DOS XL will aearch the diractory of the 
booted disk volume for a file named STARTUP.EXC. If 
STARTUP.EXC ia on the booted volume, DOS XL will 
execute that file before requeating keyboard commands. 

See section 8.3 for other details on STARTUP.EXC. 


9.6 How Execute Filea Work 



When you type ln the command *0 filename*, CP actually 
Stores that filename in an internal buffer (CPEXFN) and 
aeta a flag (CPEXFL) to indicate that a batch Operation 
ia in progreaa. 

Each time CP prompt* the uaer (e.g., with Dl«), it 
check» thi* flag to aee if batch i* actlv*. If ao. it 
opena the batch file (uaing the atored. filename). 
Unless thia ia the first time the batch file haa been 
opened (again, kept track of via a bit in CPEXFL), CP 
POINT» to the atart of the next text lin* in the file. 

The next text line ia then read lnto the command 
buffer. Then CP NOTE» the new position in the flle and 
aaves the position (in internal variable CPEXNP) for 
use by the next needed POINT procesa (aa above). 

Finally, the command in the command buffer ia executed 
juat aa if the uaer had typed it from the keyboard. 

If the command properly terminate» (e.g., via an RTS or 
a JMP through DOSVEC), the entire proceaa repeat*. 
until the execute flag i* aomehow turned off. 


' The experienced programmer will no doubt reallce that 

] changing the contenta of the varioua CPEXxx locationa 

; can affect batch exacution in posaibly Vary intereating 

i waya. These locationa are all defined in the file 

| called SYSEQU.ASM and are . offset* from the addreaa 

i contalned in DOSVEC (location S000A). See, aa an 

— ] example, the "program controlled atop" mentloned in 

I 9.4.2, above. 

_. _ j See also section 10.2.3, which repeata »oma of thla 

-" V - - < material. 
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Saction 10: Aaaembly Längung« and DOS XL 


A* mentloned ln Saction 1.6, DOS XL la dealgned aa « 
iayer'ed operating ayatam. Application programa 
Iincluding languagea auch aa BASIC XL) ara eapactad to 
call tha operating ayatera “properly*, through tha 
ayatam call vector (labeled *CIO" in SYSEQU.ASM). I n 
turn, tha CIO will determlna which devlca la to raceiv« 
what I/O requeat and handlaa moat ot tha work 
. tranaparant to tha calling program. 

If a program raatricta itaelf to proper Calla to CIO 
uaing labela provided in SYSEQU.ASM, tha program ahould 
trahdfer virtual, ly wlthout changa from ona varaion ot 
DOS XL to another. (Probably tha only othar araaa ot 
Change would involve memory map uaaga.) 

In any caae, harewich ia a daacription ot tha proper 
aaaembly languaga ca 11ing aequancea and parametera 
under DOS XL. 







J0.1 Int«rfaclng to l/o Routin«* 


10.1.1 Th« Structur« of the IOCB'» 


Whan « program call* th« OS through locatlon *CIO', OS 
axpacts to b* given tha address of a proparly formatted 
IOCB (Input Output Control Block), For «iwpllcity, we 
hav« pradefinad 6 IOCB'«, «ach 16 bytas long, and the 
calllng program «peciflaa whlch ona to u«« by paaajng 
tha IOCB numbar time« 16 in th« 6502'*, X-regist«r. 
Thu«, to accea* IOCB numbar four. th« X-ragiatar ahould 
contaln $40 on «ntry to OS. Notic« that th« IOCB 
number corraaponda dlractly to th« fll« numbar ln BASIC 
(aa ln PRINT 16, «tc.). The IOCB'* «r« locatad from 
$0340 to $03BF on the Atari (but you raally ahould uaa 
th« equataa from th« dlak fil« “SYSEQU.ASM* rath«r than 
ralylng on hard-codad addresae*.) 

When the OS geta control, It ua«a tha X-reglster to 
inspect tha approprlat« IOCB and determlne Juat what it 
waa that the ua«r wanted done. Figur« 10-1 giv«a the 
DOS XL Standard-name for each fiald ln th« IOCB along 
with a «hört deacrlptlon'of th« purpoa« of th« fleld. 
Study th* flgur« bafor« proceedlng; 

Tha uaar program ahould NEVER touch fleld« ICHID,ICDNO, 
ICSTA and (CPUT, aa they ara aet by tha’ OS. In 
addltion, unlaa* the partlcular dovlce and I/O requast 
requires it, th« program ahould not chang« ICAUX1 
through ICAUX6. Th« moat important fleld 1* the 
one-byta comraand code, ICCOM, whlch teil« th« oparatlng 
ayatem what function la dealred. 


l * 
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IOCB STRUCTURE 

r **- ! 

FIELO 

NAME 

OFFSET 

MITHIN 

IOCB 

(bytes) 

SIZE 

OF 

FIELO 
(bytea) 

* 

PURPOSE OF FIELD 

■w • 

JT . ■ 

ICHID 

s 

1 

SET BY OS. Index into device 
name tabla for.currently OPEN 
flle, aet to $FF if no fll« 
open on thla IOCB. 

■- i 

1 

ICDNO 

1 

1 

SET BY OS. Device number 
(e.g., 1 for *Dl«xxx* or 2 for 
*D2iyyy“) 


ICCOM 

2 

l 

The COMMANP requeac from uaer 
program, qefinea how reat of 
IOCB ie formatted. 


ICSTA 

3 

1 

SET BY OS. Last atatua raturned 
by device. Not necesaarlly the 
atatus returned via STATUS 
command requeat. 

I 

* ICBA0R 

* 

- f i 

i 

i 

4 

2 

BUFFER ADDRESS. A two byte 
address in normal 6502 low/high 
Order. Specifiea address of 
buffer for data transfer or 
address of fllanair.fe for OPEN, 
STATUS, «tC. 

. • 

ICPUT 

‘ • • • • . ■ 

6 

2 

SET BY OS. Address minus ona of 
device*s put-one-byte routine. 
Posaibly useful when high speed 
single byte transfer« ara 
needed. 

\ 

< 

: 1 
] 

ICBLEN 

8 

2 

BUFFER LENGTH. Specifles 
maxlmum number of bytes to 
transfer for PUT/GET Opera¬ 
tion«. NOTEi thls length is 
decremented by ona for «ach 
byte transfered. 
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ICAUXl 

10 

1 

Auxlliary byte number ona. Used 
ln OPEN to apeclfy kind of flla 
accesa needed. Soma drivera can 
mako additional uaa of thla 
byte. 

ICAUX2 

11 

1 

Auxilllary byta number two. 

Some serial port functiona may 
use thla byte. This and all 
followlng AUX bytea ara for 
special use by aach device 
drlver. 

ICAUX3 

ICAUX4 

12 

2 

For diak filea only: where the 
disk aector number ia passed by 
NOTE and POINT. (These bytea 
could be used separately by 
other drivera. 

XCAUXS 

14 

1 

For diak filea only: the byte- 
within-aector number paaaed by 
NOTE and POINT. 

ICAUX6 

15 

1 

A spare auxilllary byte. 


FIGURE 10-1 
IOCB STRUCTURE 



LEGENDi **• Set by OS whan fchia 

coramand ts used 

'buffar* Address of • data buffar 
'filenama' Addreaa of a fllanania 

Figura 10-2 IOCB Flald Uaaga 




































11 

12 

13 

1 H 1 

15 

l 

I 

I 1 

I I 1 

I 

c 

C 

C | 

1 C 1 

c 

A 

A 

A 1 

1 A ! 

A 

U 

U 

U 1 

! u i 

U 

X 

X 

X 1 

1 x 

X 

2 

3 i 

i I 

5 ! 

6 


I copm 


| CCLOSE 


CSTAT 


langth 


CGTXTR 


CPTXTR 


CGBINR 


CPBINR 


| sec nun» Ibytal I CNQTE 


I aac nun |byta| I CPQIKT 


*length' Length of a data buffer 
•mode* Hoda of OPEN Cl.e., read, wrlte. etc.) 
*aec nun* Sactor number, aee aactlon 10-1*2 
•byta* Byta in aactor, aea aactlon lft.1.2 

pigure 10-2 Ccon't.) 
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10.1.2 Tha I/O Commanda 

Figura 10-2 providaa a tabla of I/O commanda and thair 
uaaga of tha varioua fialda of tha IOCB'a. Tha firat 
acven ara DOS JCL oriented and will ba daalt with ln 
part A) of this aactlon. Tha laat aix ara Flla 
Manager specific and ara diacusaad in part B). 

Most of tha comaianda manipulate a davlca in soma way, 
ao maybe wa ahould talk about them for a moaent. 
Device namea undar DOS XL ara very aimpliatlct they 
consiat of a single latter xjptlonaliy foilowed by a 
aingle dlglt uaed to daflna a specific davlca whan more 
than one of tha same kind exiat (Ex.- 01» or 02»). 

Traditionally (and, in tha case of Atari diek filaa, of 
necesalty) tha devica nama is foilowed by a colon. The 
following devicea ara impleraented undar Standard DOS XL 
and Atari DOS» 

E» The keyboard/acreen editor davlca. Tha normal 
conaole output. 

K» The keyboard alone. Uae thia devica to bypaaa 
editlng of user input. 

Si The acrean alone. Can be either charactera (ala Ei) 
or graphics. 

P» On tha Atari, the printer. Tha Standard devica 
driver allows only one printer. 

C» The caaaette recorder. 

Di The disk file manager, which also uaually raquirea a 
file nama. 

Other devica namea aro poaaibla (a.g., for RS-232 
Interfaces), and in fact the aase with which other 
devicea may be added ia anothar mark- for tha Claim that 
DOS XL ia a TRUE operating System. Tha atructurs of 
devlce drivers is material for a latar aection (10.3), 
but we ahould like to point out that, on the Atari, the 
OS ROM includes drivers for all the above except tha 
diak. In fact, tha drivers account for over 5K bytes’ 
of the ROM Code. The acreen handlar, with all ita 
aaaociated editing and GRAPHICS modea, occupiaa about 
3K bytes of that. 





















A) tti« Standard DOS XL Comroands 

The OS itself only understands a few fundamental 
commanda. but DOS XL alao providea for theextended 
commands neceasary to aoroe devlcea (XIO in BASIC). In 
any"caaa, each of theao fundamental commanda deaarves 
a ahort daacription. ... ; •_ _ . ; ■ . 


Open a davice (synonyme» file, IOCB, channal) for read 
and/or write acceaa. OS expect. ICAUXl to contaln . 
byte that apeciflaa tho mode of acceaa» 


ICAUXl 

4 

6 

e 

9 

12 


MODE 

Read Only 

Read Directory Only 
Hrite Only 
Hrite Only Append 
Read/Write(Update) 


The name of the davice (and, for tha diak, the file) 
wuet be glven to OS, thia is accompliahed by Pacing 
the ADDRESS of a atring containin^ tha name ip ICBADR. 


Termlnata acceaa 
must be given. 

STATUS 


to a.davica/fila. Only tha comroand 


^queat the «tatu. of a device/flle. The device can 
Interpret thia requeat a« It wlahea. and PJ» back » 
(höpefully) meanlngful atatua. As «ith OPEN. the 
ADDRESS of a fil'ename muat be placad in ICBADR. 


GET TEXT 

A powerful command, 
(“GET") bytea one at a 
OPENed until either 
user ia exhausted or : 
encountered. The uaer 
placing ita ADDRESS 
(length) in ICBLEN. 


thia causea the OS to retrieve 
time fron» a davica/fila already 
the buffer space provided by the 
i RETURN character (Atari $9B) ia 
apecifiea the buffar to uae by 
in ICBADR and ita »axlmum aite 


PUT TEXT 

The~änäIogue of GET TEXT. OS Outputs characters ona at 
a time until a RETURN ia encountered or tha buffar ia 
empty. Requirea ICBADR and ICBLEN to ba apecifled. 
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GET DATA 




Extremely flexible comiund, thia cauaea OS to retrieve, 
from tha devlce/file pravioualy OPENed, tha number of 
bytea apecifled by ICBLEN lnto the buffer apecifled by 
ICBADR . NO CHECKS WHATSOEVER ARE PERFORMED OH THE 
CONTENTS OF THE TRANSFERRED DATA. 

PUT DATA 

Similar to GET OATA, axcept that OS will output ICBLEN 
bytea from tho buffer apaclfied by ICBADR .. Again, no 
data checks ara performed. 
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B) Commands Uniqu. to 


piuure 10-2 shows several DOS XL commands not 

ye! dlscussed. These “extended' co^end. ar« «cce.eed 

äh ~ —- 

‘SSM'irsi «rnt;.,:; 

Systera^ara important «nough to d*««rv« thair 
sectIons. H«*U .xamina .ach of th. Mt.nd.d di.k 
Operation» ir> * littl« detaiii 

ERASE, PROTECT, and UNPROTECT 


Also known a. Delate, Lock. and Unlock, th... thr.. 

commands slmply provlde OS with a ch ?™* 1 16) i 

the X-regi»ter 'contalns IOCß numbap 1 , , 

colaad 9 lb«r (XCCOH). and a ftl.nam. (via 
ICBADR). Hhen OS paa.e. control ^ S ^ h * n f ‘i«naSe 

is made to satlafy th. requeat. “**"* { 

may includa ‘wild cards*. a» ln (whlch will 

affect all filea on dlak drlve on« whlch hav« an S »* 
tha last latt.r o{ thair filenam« extenslon). 

BENÄHE 


Very slmilar to ERASE, et al. in uaage. Th? only 

differanca l« in tha form of tha '“*"**•/ £uk 

iai *[Dn» 3oldnama.ext,newname■«xt Nota that tha dlak 
devica apacifi.r if not and CAN NOT b. ,iv.n twlca. 

NOTE and POINT t 


___ -- "■_ theae are th. only commanda 
encountered ln Itandard DOS XL whlch us. any of th. 
AUXllllary bytea of ,tha IOCB. Eor theaa commanda, th« 

vU three of tht AUX bytes. ICAUX3/ICAUX4 ar. u.ed a. 
a conventional 6S02 LSB/MSB 16-blt Integer, they 
apeclfy th« current (NOTE) or the to-be-made-currant 
(POINt)} aector wlthin an alraady OPEN.d dlak fil«. 
ICAUX5 U similarly th« current (NOTE) or 
to-be-mad«-curr«nt (POINT) byt. wlthin that aector. 


t 
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FHS Ext.naiona of th. OPEN Comraand 


Open is not truly an extanded Operation, but for dlak 
I/O we ne«d to know that the FMS allowa two additional 
‘modaa* beyond th. fundamental OS mod.a, 

If ICAUX1 contalns a 6 when DOS XL ia call.d for OPEN, 
then th« dlak DIRECTORY ia op.ned (inat.ad of a fil«) 
for read-only accaas. Th. address ICBADR now sp.cifiea 
th« fil. (or filea, if wild carda ar« uaed) to b« 
listed aa part of a directory liating. Nota that FHS 
axpecta thia typ« of OPEN to be followad by a 
succeasion of CETREC (gat text lin«) OS Calla. 

If ICAUX1 contalns a 9, the ap«cifi«d fil« is opaned as 
a write-only fil«, but th. fil« polnt.r is aat to th« 
current end-of-fil«. 


10.1.3 Error Codes Returned 



On return frora any OS call, the Y-register contalns the 
completion Code of the requeated Operation. A code of 
one (1) indlcates 'normal statue, everything is okay*. 
(I know, vhy not zero, which is easier to check for. 
Remember, we based this on Atari's OS ROMS, whlch ar« 
good, not perfect.) By Convention, codea from $02 to 
J7F (2 • through 127 decimal) ar« preaumed to be 
•warninga*. Those from $80 to $FF (128 through 25S 
decimal) are *hard* errors. These cholces facilitata 
tha following asserobly language sequence. 

JSR CIOV 1 call the OS 

TYA i check error code 

BMI OOPS j lf $80-$FF, it-must b« an error 

In thaory, DOS XL always returns to th« liier with 
condition Codes aet such that the TYA is unnacessary. 
In practica, that 1 « probably truei but a littl« 
paranola often leads to longer lif« of both human« and 
programs. 


i 

( 













10.2 Manipulation of DOS XL 


The writer of assembly language code will moat Ukely 
need to interfac. with the Atari Operating fyatem (OS) 
in aome way. If the aaaerobly code la to become an 
extrlnaic command, there may be a need to Interface t 
DOS XL. See aection 10.1 f°r further Information about 
the OS Interface. 

If you are writing «oftware deaigned to 

DOS XL, you may need to exaraine and/or modlfy certain 
apecial Memory locatlona or acceee certain routinea 
within DOS XL. Thia aection liata and deacribea tnoae 
that we feel are the moat uaeful. 

10.2.1 SYSEQU.A3M 


Every DOS XL master diak contalna an assembler aource 
file, SYSEQU.ASM, that haa varioua co "™° nl y 
OS and DOS XL ayatera equatea. Thia .tlle J»ay b 
includad ln an aaaerably language pcogran via the OSS 
MAC/65 include function (.INCLUDE IDliSYSEQU.ASM)} 
however, it exista on the raaater diak aa a text file 
and muat be 'ENTER'ed into MAC/65 and then SAVE ed 
back to th« dlik. * 


10.2.2 CP MEMORY LOCATIONS 


The”cönünänd~Pröce.30r (CP) on the Atari 1. “ 
be placed juet after the normal Atari File Manager 
when the DOS.SYS veralon of DOS XL la uaed. Since the 
actual^locatlon of CP may Vary with different ver.lona 
of the file manager and/or becauae of different ®eraory 

configurationa. a fixed Ätarl) 
point to CP.- The location CPALOC (SSA on the Atar ) 
contalna the addre.a of the DOS XL »ndCPwarraatart 
entry point. Moat Atari programa ahould return to CP 
by JMPing to the addreae contained ln cpaloc. 



10.2.3 EXECUTE PARAMETERS 

The CP execute flag la locatad CPEXFL ($08) from the 
atart of CP. The CPALOC nay be uaed aa an indlrect 
polnter to acceaa the execute flagi 

LDY (CPEXFL |CET DISPL TO FLAG 

LDA (CPALOC),Y »LOAD FLAG 

The Execute Flag haa four bita that control the execute 
procaaai 

Marne Bit I 

EXCYES 580 If on«, an execute ie ln prooreea 

EXCSCR $40 If on«, do not echo execute Input 

to acreen 

EXCSUP $20 If one, acold atart execute ie 

atartlng. Uaed to avold a FILE 
MOT FOUMO error If STARTUP.EXC la 
not on boot diak. 

EXCHEH $10 If one, a new execute le atart¬ 

lng. Telia CP to atart with 
the flrat Uno of the file 

CP perforraa the execute function by OPEMing the file, 
POINTing to the next llna, READing that llne, NOTE Ing 
the' new next llne and CLOSEing the file. To porform 
theae functlona, CP must .ave the exacuta file narae and 
the three byte NOTE valuea. The fllenarae la eaved at 
CPEXFM ($0C) into CP. The three NOTE valuee are aavad 
at CPEXNP (SIC) into CP. (CPEXNP - ICAUXSl CPEXHP + 1- 
ICAUX4i CPEXHP + 2 - ICAUX3). By changlng the varioua 
execute control parametere, a programmer can cauae 
chalnlng of execute filea, aklpplng of certain linea ln 
the file, etc. ' 


10.2.4 DEFAULT DRIVE LOCATION 


The CP default drive file apec la locatad at CPDFDV 
($07) into OS/A+. The Default Drive here ia ATASCII 
Dm where “n" ia the ATASCII default drive number. 



i 

I 













10.2.5 EXTRINSIC PARAMETERS 

The extrin«ic commanda may be called wlth pararaeters 
typed on the command line. The CP command 

D^ipopy fROMFILE D2iTOFILE 

la an exampie of thi». The antlra command Una la 
aaved in the CP input buffer located at CPCMDB C ? 3F1 
bytea into CP and i« avallabi« to the u««r. Sine. ao.t 
cSmmand parametars ara file naraea, CP proyide« a mean. 
of «xtractlng thes« parametera aa filaname«. The 
routlne th.t' p.rforaa thia Service beging c POHFN 
(S03) bytaa Into CP . Th« routine will get 
Parameter and mova it to the filaname buffer at CPFNAM 
(521) bytea in CP. It the parameter doea not contaln a 
davlce prefix. then CP will profix the parametar wlth 
the default drlva prefix. The firjt time COPY calla 
CPGNFN the file epec "Dl;FROMFILE" ia placed at CPFNAM. 
The aeoond time COpY calla CPGNFN the flla apec 02: TO 
FILE“ ia placed ln CPFNAM. if CPGNFN wera to be called 
more tlraea. then the default file epec would be «et 
Into CPfN*tf <*t each call. To detect the #n * /e ?5 
Parameter condition, the uaer may -check the CPBUFP (50A 
into CP) call. If CPBUFP doea -not Change often a 
CPGNFN call then there are no more parametera. The 
filename buffer ia alwaya padded to 16 bytea wlth 
ATASCU EOL ($9 b) charactera. The following example 
aeta up a vector for calling the get file name routine! 


CPALOC 
'(CPGNFN 
GETFN+i 
CPALOC+l 
(0 ’ 
GETFN+2 


IADD CPGNFN 
jTO CPALOC VALUE 
»AND PLACE IN 
jADDRESS FIELD 
IOF JUMP 
/INSTRUCTION 


GETFN JMP 


The following routine get« the next file name to 
CPFNAMi 


ICRBUFP 
(CPALOC),Y 

GETFN 

(CPBUFP 

(CPALOC),Y 
NONEXT 
tCPFNAM 
(CPALOC),Y 


»SAVE CPBUFP 
tVALUE 

»GET NEXT FILE pARM 

»TEST FOR NO NEXT 
»PARM 

»BR IF NO NEXTPARM 
»ELSE GET FILE 
»NAME FROM BUFFER 
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10.2.6 RUNLOC 




Whenever an Extrlnaic command ia invoked, RUNLOC ($3D 
into CP) ia given the value of the first addreas in 
that command 1 a .COM file. Same Extrinalc commanda 
(including uaer written commands) can therefore be 
restarted by typing the RUN command. You may want to 
changa the contenta of RUNLOC to point to the warmatart 
point of your program when it'a entered the firat time 
to avoid unwanted reinitlalizatlona when re-entered. 
BASIC A+ and MAC/65 do thia to avoid Clearing any uaer 
program whlch may be in memory when returning frora CP. 
If you want to forbid re-entry, you need to aet 
RUNLOC’« high Order byte (?3E into CP) to zero« • 

LDY IRUNLOC+l »FORBID RE-ENTRY 

LDA <0 »TO HE 

STA (CPALOC),Y 


10.3 DEVICE HÄNDLERS 


As we have noted before, CIO ls actually a very small 
prograra (approximately 700 bytea). Even so, it ia able 
to handle the wide varlety of I/O requests detalled in 
the first two parts of this chapter with a aurprisingiy 
simple and conaistent assembly languaga Interface. 
Perhapa even more amazing ia the purity and elmplicity 
of the OS Interface to its device handlers. 

Admittedly, because of thls very simplicity, CIO ia 
aometimes alower that one would wiah {only notlceably 
ao wlth PUT BINARY RECORD and GET BINARY RECORD) and 
the handlera muat be relatively sophiaticated. But not 
too much so, aa we will show. 

10.3.1 The Device Händler Tablo 


At location "HATABS" in RAM. CIO haa (loaded from ROM 
on the Atari) a Hat of the Standard device« (p*, 
Dt,Et,St, and K») and the addreaaes thereof. To add a 
device, simply tack it on to the end of the Xisti you 
need only spccify the device'a name (one character) and 
the address of its handler table (mors on that in a 
moment). 

In theory, all named device handler* under DOS XL may 
handle more than one physlcal device. Just as the dl*k 
handler underatands "Dli" and "D2i", so could a 
keyboard handler understand "Kli" and "K2»". DOS XL 
supplles a default sub-device number of "1* lf no 
number is given (thus "Di“ becomes "Dlt“). 
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Fallowing is the layout of the HAndler TABieS on th« 
Atari Computers: 


HATABS 

.BYTE 

• WORD 

• BYTE 
.WORD 
.BYTE 
.WORD 

• BYTE 
.WORD 
-BYTE 

• WORD 

• BYTE 

.KORD 

• BYTE 


10.3.2 Rules for Writing Device Händlers 


Each device which has its handler addreaa placed into 
the handler address. table (above) is expected to 
conform to certaln rules. In partlcular, the driver ia 
expected to provide six (6) action subroutinea and an 
Initialisation routine.. (In practice, the current 
Atari's OS only calls the Initialisation routinea for 
its own pre-defined devices. Since this may Change in 
the future, and since one can force the call to one'a 
own Initialisation routine, we must recommend that each 
driver lnclude one, even if it doea nothing.) The 
address placed in the handler addreaa table muat point 
to, again, another table, the form of which is ahown 
below (Figure 10.3), , 


HÄNDLER 

•WORD «address of OPEN routine»-! 

.WORD «address of CLOSE routine»-! 

.WORD «address of GETBYTE routine»-i 
.WORD «address of PUTBYTE routine»-l 
.KORD «address of STATUS routine»-! 

.KORD «addreaa of XIO routine»-l 

JHP «addreaa of initialisation routine» 


Figure 10-3 


5031A 

*P' » the Printer device 

PDEVXCE ; and the addreaa of ita driver 

’C' I the Cassette device 

CDEVICE 

■E‘ i the acreen Editor device 

EDEVICE 

'S' / the graphica Screen device 

SDEVICE 

*K‘ » the Keyboard device 

KDEV1CE 

0 I sero marks the end of the 

table 

0 i ...but there'a room for 

several 

0 > ...more devices 

et cetera 



Notice the alx addresaca which muat be speclfied: and 
note that in the table one must aubtract one front each 
address (the *-1* aimply makea CXO'a Job 
eaaler... .honest). A brief ward about each routine ia 
given in the following pagas. 

Device OPEN 


The OPEN routine muat perform any Initialisation needed 
by the device. For raany devices, eich aa a prlntac, 
thia may conalst of aimply checking the device atatus 
to insure that it ia actually preaunt. Since the 
X-regiater, on entry to each of thaaa routines, 
contains the T0C8 number belng usad for thia call, the 
driver may examine ICAUX1 (via LDA ICAUXl.X) and/or 
XCAUX2 to determine the kind of OPEN being requeated. 
(Caution: CIO preempta bita 2 and 3 (}04 and 508) of 
1CAUXI for read/write acceaa control. These bita may 
be examined but should normally not be changed.) 

Device CLOSE 



The CLOSE routirs ia often even simpler. It should 
"turn off the device if necoasary and poeaible. 

Device PUT and GET BYTE Ruutinea 


The PUTBYTE and GETBYTE foutines are juat whst are 
implied by their namest the device handler must anpply 
a routine to output cne byto to the da<'lce and a 
routine to input one bytu freu the de/ien. HOWBVER, 
for many devices one or the other of these routines 
doesn't make sense (ever triod to li.put from a 
Printer?). In this caae the f >utin« may ::imply RTS and 
DOS XL will supply an error Code. 

Device STATUS Routine 


The STATUS routine ia intendad to Implement a dynamic 
atatus check. Generally, if dynamic checking is not 
desirable or feasible, the routine may aimply return 
the atatus value lt finde ln tha uaor'a IOCB. However, 
it ia NOT an arror under DOS XL to cell the atatus 
routine for an unOPENed device, so be caraful. 

Device Extcnded I/O Routine(a) 


The XIO routine doea Juat what ita nama implies: it 
allows the uaer to call any and all special and 
wonderful routinea that a given device handler may 
choose to Implement. OS doea nothing to procasa an XIO 
cali except pass lt to the appropriate driver. 
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General Comment» on Device I/O Routine» 

Ir» general, the AUXllllary byte« o( «»ch IOCB »re 
available to fach driver. In practicf, it i« beat to 
avold ICAUX1 and ICAUX2, aa »everal BASIC and OS 
commanda will alter them to their will. Bote that 
ICAUX3 thru ICAUX5 may be uaed to paaa and fecelv« 
Information to and from BASIC via th# NOTE and POIN’l' 
comroanda (which ar» actually apacial XIO commanda). 
Flnally, driver» ahould not touch any other l>ytea l n 
the IOCBa, «apaclally the flrat two bytaa. 

Notice that handlera need not b» concerned vlth PUT 
BINARY RECORD, GET TEXT RECORD, etc.I OS perform» all 
the needad houaakaeping for theaa uaer-ievel commanda. 

10.3.3 Rulea for Adding Thing» to OS 


1. tnapect the ayatem HEMLO pointer (»«« 

SYSEQU.ASM for the actual location) . , 

2. Load your routlne (including needed buffera) 
at the current value of MEMLO. 

3. Add the »Ire of your routine to MEMLO. 

4 . Store th» reaultant vaiue back in HEMLO. 

5. Connect youf driver to OS by adding ita nam» 
and addreaa into the handier addraaa table. 

6. Pool OS #o that if SYSTEM RESET la hit atepa 
3 thru 5 will be reexecuted (becauae SYSTEM 
RESET indaed reaeta the handier addreaa table 
and th« valuq of MEMLO). 

In polnt of fact, atep 2 ia the hardeat of theaa to 
accompliah. In Order to load your routlne at wherever 
MEMLO may be polnting, you need a ralocatable (or 
aelf-ralocatable) routine. Sinca thar# ia currently 
no aaaembler for th# Atari Computer» which producea 
intrinaically ralocatable code, thia ia not an eaay 
taak. But it may not be neceaaary if you are writlng 
code for your own private ayatem inatead of the 
general public. 

Step 6 ia accontpliahed by maklng Atari OS think that 
your driver ia the Diak driver for Initialiration 
purpoaea (by "atealing" the DOSINI vector) and then 
ca 11 Ing the Diak*» InitialUer youraelf befor# atepa 3 
thru 5 are performed again. 
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10.3.4 AN EXAMPLE PROGRAM 


Thia driver, included in aource form on your diak aa 
"MEM.LIS“, builda a new driver and adda it to the 
operating ayatem. Th# “device“ being driven ia aimply 
exceas ayatem memory within your Computer. Thua, you 
may (for example) uae thia ar# aa • paeudo-dlak file 
for paaaing data between aequentially callad program#. 

Soma word» of caution ar# in ord«r. Thia driver doaa 
NOT perform atep 6 aa notad in the laat aection (but it 
, may be reinitlalired via a BASIC USR call). It doea 
- NOT perform aelf-relocation» Inatead it aimply locatea 
itaalf above all normal low memory uaage («xcept th# 
aerial port drivera, which would have to be loaded 
AFTER thia driver). If you aaaemble it youraalf, you 
could do ao at the MEMLO you find in your normal ayatem 
confIguration (or you could improve it to be aelf- 
modifying, of courae). 

Other caveats pertaln to the handier*» uaage» it uaea 
RAM frora the contenta of MEMTOP downward. It doea NOT 
check to aee if it haa bumped into BASIC'» MEMTOP ($90) 
and hence could conceivably wipe out programa and/or 
data. To be aafe, don*t write mora data to the RAM 
than a FRE(0) ahowa (and preferrably even leaa). 

In Operation, the M» driver reinitializea upon an OPEN 
for write access (mode S). A CLOSE followed by a 
aubaeguent READ acceas will allow the data to be read 
in th« Order it was written. MORE CAUTIONS» don't 
change graphlca modea between writing and reading if 
the change would uae more memory (to be aafe, aimply 
don't change at all). The M» will perform almoat 
exactly aa if it were a cassette file, ao the uaer 
program ahould be data aenaitive if neceaaary» th« M< 
driver will NOT itaelf giv« an error baaed on data 
contenta. Note that th« data may be re-READ if desired 
(via CLOSE and ra-OPEN). 

A auggeated aet of BASIC programa ia prea«nted on the 
next page. 









Ending of PROGRAM 1« 

9900 OPEN #2,8,0,“Mi* 
9910 PRINT 12; LEN(A?) 
9920 PRINT 12; A? 

9930 CLOSE 12 

9940 RUN “DiPROGRAM2“ 

Beginnlng of PROGRAM 2i 

100 OPEN »4,4,0,“Mi* 
110 INPUT »4,SIZE 
120 DIM STRING?(SIZE) 
130 INPUT #4, STRING? 
140 CLOSE 14 


BASIC XL usera might find RPUT/RGET and BPUT/BGET to be 
useful tools her« instead of PRINT and INPUT. And, of 
course, usera of any other language(s) might find thia 
a handy inter-prograra Communications device. 
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Saction Hi FILE STRUCTURE 


DOS XL varaion 2 was produccd to provlde tha maximum 
compatibility poaaible with Atari’a DOS 2.0a. In fact 
tha FMS uaad la identical to that uaad by Atari (for ä 
almpla raaaom we wrota Atari’a DOS). For reaaona 

known beat to Atari, we wäre i^atructed to craata 
Atari a FMS around a linkad-sactor diak apaca 

management acharaa. In aasenca, thia maana that tha 

* ° f ® ach * octor tn « «Hak flla contain 

a link to tha naxt aector in that aama flla. Tha 

positive raault of thia la that ona procjucea a 
ralatlvaly small, memory-raaident, diak managar which 
v capabla of dynamlcally allocating 

lakette-apace (unllke, for axampla, a contiguoua fila 
managor-). The biggeat diaadvantage of tha achema 
aeems to ba that ona may not do direct (random) acceaa 
to the bytaa of auch filaa, aa ona CAM do with aither a 
contiguoua or mapped fila allocatlon tachnlqu«. Also, 
a diak arror in the middla of a llnked fila maana a 
loss of acceaa to tha reat of tha fila. 

The purpose of tha FMS ia to organiza the 720 data 
aectora availabla on an B10 (or ita double danalty 
äquivalent) diakette into a aystem of named data filaa. 
FMS haa thrae priroary data atructurea that lt uaaa to 
organic« th« disks 

l* Volum« Tabla of Contents (VTOC)i a aingla diak 
aector which kaepa track of which diak aectora ara 
availabla for uaa in data filaa. 

2. Directoryi a group of aight contiguoua aectora 

**« oclat « <11« namaa with the location of 
tha filea aectora on tha diak. Each Directory 
entry contalna a fila name, a pointer to-the flrat 

Information!: * l " th * flU * ‘ 0ma 

3. Data Sactorai aector« contalnlng tha actual 
data and aoma control Information that links on« 
data aector to th« naxt data aactor in th« fil«. 

NOTEi sine« doubl« denaity diakatta aectora contain 256 
bytea whareaa aingla denaity (810 driva) aactor« 
contain only 128, cartain absolut« byt« numbar 
raferencea may Vary depending upon th« diakftt« in ua«. 
Throughout thia chapter. in auch casaa, th. aingU 
denaity numbar ia glven followed by th« doubl, denaity 
numbar in aquar« bracketa (thua). ^ 
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11.1 DATA SECTORS 


A Data Sector la uaed to contain the Eil«'» data bytea. 
Each 128 [2563 byte data aectoc ia organlxed to >iold 

125 [253] bytea of data and three bytea of control. 
The data bytea atart with tha «trat byta (byta 0) ln 
the aectoc and pun coptlguously up to, • and including, 
byta 124 C2523. The control Information atarta at byta 
125 [2533- 

The sector byta count ia contalned in byta 127 [2553* 
Thia valua ia the actual numbar of data bytaa in thia 
partlcular aactor. The valua raay ränge from sero (no 
data) to 125 [2533 (* full aactor). Any data sector in 
a file may ba a ahort aactor (contaip lass than 125 # 
[253] data bytea). 

The left six bftij of byta 125 [2533 cor.taln the flla 
number of the file. Thia nuraber correapoinda to the 
location of tha file'a entry in tha Directory. 
Directory entry sero in Directory aactor $169 haa a 
file number of sero. Entry one in Directory aactor 
$169 haa a file number ona, and ao forth. Tha file 
number valua may ränge from sero to 63 ($3?). Tha flla 
number ia uaed to Ineure that the aectora of one file 
do not get mixed up with tha aectora of ar.other file. 

The right two bita of byte 125 [253] (and all aight 

bita of byte 126 [25<(]) are uaed to point to the next 
data sector in the file. The tan bit pur.ber contalna 
the actual disk aactor number of the next aactor. Ita 
valua ranges from sero to 719 ($2CF). If the valua ia 
sero then there are no more aectora ln the flla sector 
Chain. The last aactor in the file aactor Chain ls the 
End-Of-File sector. The End-Of-File aactor will almoet 
alwaya be a ahort sector. 


11.2 DISK DIRECTORY 


The Directory starte at disk sector $169 and continuea 
for aight contlguous aectora, endlng .with sector $170. 
These aectora wäre choaen for the diractory becauae 
they ara ln the center of tha diak and therafore hava 
the minlmum average seek time from any place eise on 
the disk. Each directory aactor haa aoace for aight 
file entriss. Thua, it la poasible to hava up to 64 
fites on ona diak. ...... 
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A Diractory entry la 16 bytea in eise, ae liiuatrated 
by Figura 11-1. Tha directory entry flag fiald givea 
specific atatua Information about tha current entry. 
The diractory count fiald la uaed to Store the number 
of aectora currantly uaed by the flla. Tha last eleven 
bytea of the entry are the actual file nama. Tha 
primary nama ia laft juatified ln the prlmary name 
fiald. The name axtenalon ls left juatified ln the 
extenalon fiald. Unueed filaname charactera ara blanke 
($20). Tha Start Sector Number fiald polnts to the 
first aactor of the data file. 


Starting Length 
Byte f of Fleld 

of Fiald (bytea) Turpoae of Field 


1 Flag byta. Meaninga of 
bita i 

$00 Entry never uaed 
$80 Entry was deleted 
$40 Entry in uae 
$20 Entry protected 
$02 a veraion 2 file 
$01 Now writing flla 

2 Count (LSB.MSB) of 

aectora in flla 

2 Start aector (LSB.MSB) 

of link Chain 

6 File name, prlmary 

3 File name, extenalon 


Figura li-1 


Directory Entry Structure 
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(sector $169) 
firat directory 
■ector 


1 F1LEA 

ptr 1 

-1 FILEB 

ptr 1 

1 1 «tc. 

1 I 

I 1 

! 1 

1 1 

1 

1 

i 

i 

i 

1 (sector $16A) 1 

«tc. 1 


I 



Figur« 11-2 

Version 2 Directory Structure 


NOTE! only eight file directory entrlee er« «tored per 
■ector, «ven on double den«ity diekette«. 
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11.3 VOLUME TABLE OF CONTENTS (VTOC) 


Th« VTOC eector ($168) ia ueed to keep treck of whlch 

* r * * vailab l« for d«t« «ile ueeg«. figur« 
11-3 illuatrataa th« Organisation of th« VTOC eector. 
The »oet important part of th« VTOC iy th« «ector bit 

““P, 1 * * contiguou« String of 90 byte*. 

öf 720- (93 blt< - Th ° r “ * r * * total 
nn..lK? 93 35 bit * ln th “ bit ma P—one for «ach 
po..ibl« «ector on an 810 di.kett«. The 90 byte. of 

v T2f byt * t,n (50Al - Tha i*«tio.t bit 
($80 bit) .of byt. $0A reepreeent« «ector r.ro. Th« bit 
3u»t to th« right of th« leftaoet bit ($40 bit) 

h!?!*?*?** •* ctor ona * Th« fightaoet bit (bit $01) of 
byte J63 repreaant« «ector ,7X9. 


Starting Length 
Byt« I of Flcld 

of Field (byte«) Purpoee of Field 


f * Reeorved (for type Code) 

* * Total nuraber of «ector« 

^ J Number of unu«ed «ector« 

' 5 Raaerved 

1 “ Sector ueage bit map 

Each bit repreaanta e 
particular aectort 
« 1 bit indlcate« an 
available «ector, 
a 0 bit indicata« ’« 

... .«ector in ua«. 

Reaerved. (could be uaed 
for Version 2 type 
DOS with mor« than 
720 «ector« per di«k) 


Figur« 11-3 

Structure of th« VTOC Sector 
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Appendix Ai CUSTOMIZING POS XL 


Although DOS XL was deaigned and implementod with the 
average uaer in mind, no one piece of yoftwaro can ever 
be all things to all people. For. ,fhat . reaaon, a 
degree of flexibllity exiata over certafn »«pacta of 
the ayatem which allowy the uaer to nodify DOS XL to 
suit hi« own fast««. The following aections deycribe 
the most uaeful modifications which may be performed• 


A.l BUFFER ALLOCATION 


DOS XL aliowa the uaer to apecify the atartlng addreaa 
of the ayatem file buffara and the number of buffara to 
be uaed. Th« location of the worda which apecify these 
Parameter» ia not guaranteed to remain flxed in future 
releasea. Therefore, it ia »trongly auggeated that the 
user dealring to change one or both of these valuea 
check the file "SYSEQU.ASM", aupplled on the DOS XL 
disk, to be aure of the latest ayatem Value. < Aa of the 
printing of thi« manual, the following locations ara in 
uaei 

label location uae. 

SASA $070c Start of buffery 

SABYTE $0709 | of buffer« 

Preauming the uaer wlahea to change SABYTE. the flrat 
queation that needy answered ia *How many buffera do I 
need?" The rufe« followi i 

Amount of yoace requiredi Tor aingle dansity dlakettes, 
uae 2 'buffery per activ« drlve AND 1 buffer per 
aimultaneouely open file. for double denalty 
diskattes, uae 2 buffera per activa drive and 2 
buffer» per yImultaneously open file. EACH BUFFER 
IS 12B BYTES LONG. 

Be aure you have enough room at the location you 
will apecify by SASA to contaln the buffer« 
required. 

Specifying the number of buffarai Do NOT include the 
drlve buffera in the count of buffera you give DOS 
XL. Inatead, «imply apecify the FILE buffer« in 
location SABYTE. 







A.2 SPECIFYING EXISTING DRIVES 


Under veralon 2, the byta location DRVBYT (at $70A, buC 
conault SYSEQU.ASH to confirm current location) 
Controls which drlvea ara active. Each bit of DRVBYT 
represents a given drlve.' Th« leaat aignlficant bit of 
DRVBYT represents drive 1, the next bit represents 
drive 2, etc., up to the moat aignlficant bit which 
represents drive 8. 

Zf a bit ia DRVBYT ls on (aet to one), the drive 1» 
active. If a bit is off, the drive ia inactive. Thua 
a value of $05 would imply that *Dli" and "D3i* ar« 
active. 

CAUTIQN7 «imply changing the bit« in DRVBYT or adding 
Information to the disk drive table is NOT aufficient 
to change the «ystem confIguratlon. After changing the 
bita, ycu must cauae DOS XL to reinitiallxa itaelf. 
This may be accompliahed by slmply hitting the SYSTEM 
RESET key frora the keyboard, or calling the DOS 
Initialisation routine, via DOSINI, fron a running 
program. 


i A.l SAVING YOUR MODIFIED VERSION 


Saving a modified veraion of DOS XL is extremely simple. 
With Version 2, «imply uee the INIT command and, when 
the menu appear», apecify "Write DOS.SYS file only* (or 
go ahead and initlalize the disk if it ia a new 
disk...just be careful not to reinitiallze a disk with 
valuabie goodiea on it). However, thia Option can HOT 
be taken when an axtended memory DOS »ystem is active. 
See sections 3.7, 6.8, 7.7 for more Information. 











Appendix Bl DOS XL AMD THE 850 IHTERFACE MODULS 


B.l Loading the RS232 handler 


When using Atari DOS 2.0s, the only way to load the 
RS232 device handler (Rnt) from the 850 Interface module 
ls through the uee of an AUTORUH.SYS file (aee «ection 
8.2). Thie Option io also available to DOS XL users. 
Another Option ia, however, available to you. After 
booting DOS XL, you can «imply ieeue the following 
command»t 

1) from the DOS XL menui 

You typei X 

and then, when prompted for a command, 
You typei RS232 tRETURN] 

2) or, from the DOS XL command proceasort 

You typei RS232 CRETURH] 

Thia sequence of command» will cause the RS232 device 
handler to ba loaded into the aystera. You can then 
refer to the 4 RS232 porta on the 850 Interface module 
as “Rli" through •R4i“, respectively. 


B.2 Buga in the RS232 driver 


Unfortunately, the device handler whlch loads ln from 
the 850 interface module ie not perfect. The moat 
aerioua flaw occura when you puah SYSTEM RESET after the 
RS232 driver hao been loaded into memory. Under certaln 
circumatancea, your Atari Computer will “hang“, freezlng 
the Keyboard, after preaaing that Key. For thia reaaon, 
many Atari reference booKa recommend that you NEVER 
preaa SYSTEM RESET after loading the RS232 driver. 
Under DOS XL, however, there is a solutlon to this and 
other probiemo. On your maater dlaK there ie a file 
called "RS232FIX.COM* . Thia file la almost ldentical to 
the "RS232.COM“ file which ie normally employed to 
install the RS232 handler. Thefixed Version attempta 
to correct aome of the Known buga ln that handler. 

You may aeK, “Why not juat include the correct Version 
on the DOS XL maater diaK7* Well, Atari haa produced 
aeveral veralona of the 850 interface module. OSS haa 
almost no way of Knowing whether the corrected Version 
worKa with all auch revialona so, rather than 
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introduclng.new problema. both the original and the 
fixed Version ara lncluded. 

To teat the “RS232F1X.COM* file with your 850 module. 
eitheri 

1) Uaing the DOS XL menui 

You type« X . - 

When prompted for a command, , 

% type« RS232FIX [RETURH] 

2) or ualng the DOS XL command proceasort 

You typei RS232FIX fRETURH] 

If the RS232 handler loaded in this way seema tö Work 
£f°?! rly ’ you u “° lt •xclusivaly for loading the 

Ru232 handler, ignorlng the original RS232 command. 













APPENDIX C - SYSTEM MEMORY MAPS 


C.l ATARI ZERO PAGE MAP 


location uaage ■ 

0-9 ayatem zaro page 

A-B CPALOC kpown to Atari DOS as DOSVEC 

C-D DOSINI vactor to FMS Initialisation 

E-42 ayatem zero paga 

43-49 fras zaro paga 

4A-7F ayatem zaro paga 

80-FP üser and language zero paga 

B0-CD BASIC XL and Atari BASIC zaro paga 

D2-FF floating point zaro paga 

C.2 ATARI SYSTEM MEMORY MAP - DOS XL varslon 2 


location uaage 


100-1FF 6502 «tack area 

200-319 ayatem ram 

300-30B DCB (davice control block) 

31A-33F devica handler table 

340-3BF IOCB'a - 8 st 16 bytea mach 

3C0-57F ayatem ram 

580-5FF El text bgffer 

600-6FF uaer ram 

700-variea DOS XL — fila managet and CP 

■or just buffers, etc., whan uaing 
»xtended memory DOS «yatema 
709 SABYTE numbar of 128 byte fiie buffara 

70A DRVBXT bit mapi accesalble drivea 

70C SASA addreäa of Start of buffara 

(2E7J-BFFF user, language, and graphics mamory 

, Notes (2E7) meana "contenta of 
location 502E7“ (LOMEM). 

A000-BFFF • SuperCartridge and Atari BASIC memory— 

also uaed by DOS XL for fila manager 
and CP in "DOSXL.SUP" Version of tha 
axtended memory DOS syatepi 
C000-CFFF Unuaed in Atari 400/800, OS ROM 

in XL-seriea, bank swltched with RAM 
D000-D7FF I/O locationa 

D500-D5FF Uaed by SuperCartridge for bank aalact 

D800-DFFF Floating Point ROM 

E000-E3FF Character Set ROM 

E400-FFFP OS Drivers, CIO, etc.—in ROM 

E400-FFF9 Bank- aelectable RAM uaed by DOS XL 

for flle•manager, CP, etc., in the 
“DOSXL.XL* Version of extanded memory DOS 
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Appendix Di Atari Writer and Qthar Cartridges 


0 

Cartaln cartridge-baaed producta,,inciuding ATARI WRITER 
from Atari, Inc., will not work properiy if your boot 
disk contalns a STARTUP.EXC fiie. If you ara uaing a 
product auch as ATARI WRITER, make a special boot dlak 
aa followai 

1) Duplicate your.master diak onto a blank ona. 

2) Eraaa tha fiie STARTUP.EXC on that dlak. 

3) Eraae tha fiie MENU.COM on that dlak. 

(only if you want mora memory apace) 

You ahould now uaa thia dlak for booting into ATARI 
WRITER (you may uaa thia diak for booting into othcr 
producta, but you will not hava the menu if you go to 

DOS). •' 
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APPENDIX Ei Errora 


f 


E.l TYPES OF ERRORS 


All DOS XL operationa return a atatua valua in tho 
IOSTAT Eieid. DOS XL Convention ia that atatua valuea 
of $80 op greater indicate aorae aort of error. There 
are four fundamental kinds of errora that can occur 
with DOS XLi 

Hardware Errora 


Such aa attempting to read a bad diak, write a 
read-only diak, etc. 

Data Tranafer Errora 


Errora whtch occur when data is tranaferred between the 
Computer and a peripheral device. Examplea include 
Device Timeout, Device HAK, Framing Error, etc, 

Device Driver Errora 


Found by the driver for the glven device, aa ln (for 
the DFM) File Not Found, File Locked, Invalid Drive 
Number, etc. 

OS Errora 


llsually fundamental uaage problema, auch aa Bad Channel 
Number, Bad Command, etc. 


E.2 ERROR CODE LISTING 


The Hat of error codea which followa ia not neceaaarily 
exhauative. but it doee repreaent all error codea which 
will normally be returned fro DOS XL or any of the Atari 
device drivera. 



t 


ERROR CODE 
HEX DECIMAL 


HEARING 


531 1 

532 2 

533 3 

583 ' 128 

581 129 

582 130 

583 131 

584 132 

585 133 

586 134 


Ho error ob warning. 

Truncated ASCII line. The OS did not 
find a CR within BUFLEH for ASCII line 
I/O. 

End of file look ahead. The laat byta 
tranafered from the device driver waa 
ita end-of-fIle byte. The device 
driver muat aet thla atatua. ao it ia 
beat to verlfy that the device belng 
uaed ia capabla of returning thla 
atatua befora depending on it. 

Operation aborted. Set by Device 
Händler. (Alao BREAK abort on Atari.) 

File already open. Prograja ia trying 
to open a Channel (IOCB) that hat 
already been OPEUed. 

Device doea not exiat. The device waa 
not found in the OS device tabla. 
Often cauaed- by forgetting the diak 
drive namo when uaing a diak fiie. 

File ia write only.' Program tried to 
read from a file which can only be uaed 
for writing (l.e., file waa OPENed with 
AUXl aet to 8 or 9). 

Invalid Command. CIO'haa rejected your 
requested command. (Examplet program 
tried to do XIO to a device which haa 
no extended operationa defined.) 

Dovice/File not open. The IOCB haa not 
been OPENed for the Operation. Hoat 
I/O requeata require that the Channel 
be OPENed before a requeet can be atade. 

T* 1 * IOCB apecified ia invalid. Only 
IOCB numbora 503, 513, 523, $30, 540 . 
553, 560, and 573 are valid. From aome 
languagea, theae will be aeen aa 
Channels 0 to 7. 
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?§3 

$aa 

JB9 

$SA 

$83 

$ac 

$80 

$8E 

$8F 

$93 

$91 

$92 


136 

1 ?? 


139 

143 

141 

143 

143 

144 

145 

146 


Fila la read oniy. Program triad to 
weite to a file which car» only b« uaed 
for peading (l.a., file waa OPENed y(th 
AUX1 apec(£ied ia ( or 6. 

End of fila. Ho mora data in file. 

Truncated racord arror. Uaually occura 
whon tha line you ara raading i» longar 
than tha maximum racord aisa apaciflad 
in thg Cali to CIO (iine orlented I/O). 
Can't occur with binary I/O on verfiop 3 
OS/At. 

Davica tlmeout arror. Uaually aot by 
tha serial bua I/O handlar l'SIO") 
bacauaa a davica did not raspond within 
tha alloted tima aa seit by tha OS. 

Oavica KAK arror. Atarii aarial I/O 
arror. 

Serial fraraing arror. Atarii aarial I/O 
arror. 

Curaor out of ranga for specific 
graphica mode you ara "in. (Could ba 
uaed for ' eimilar meanlnq ' by a 
pon-graphica davica.) 

Serial bua ovarflow. Atarii Computer 
could pot renpond fast anough to aarial 
bua Input (SIO arror). 

Checkaum arror. Communications ovar tha 
aarial bua ara garblad (Atari SIO 
arror) • 

1) Oavica done error. A valid command 
on tha aarial bua via not axacuted 
properly. Atarii diak rotational apaed 
needa ad- justmant. 2) Nrite protact 
arror* Tha diakatta haa a vrlte protact 
tab in place. 

Illegal acreen moda arror. Bad graphica 
mode numbar. Other davicaai AUX1 and/or 
AUX2 bytaa in I0CB ara illegal. 

Thia arror meana tha functlon you triad 
to do haa not baen imple.mantad in tha 
devica handlar. (Examplei attempt to 
POINT with tha graphica devica.) 


$93 147 Mot anough RAH for tha graphica moda you 

requested. (Could ba uaed by cuatom 
drivara for a aitnilar meaaaga.) 

KOTEi Errora $A0 through $AF ara fila manager arrora. 

$A0 160 Eithar a drive I HOT between 1-8 or 

driva waa not powared on. 

$A1 161 Too many OPEH filaa. Ho frae aector 

buffers to uae for anothar fila. 

$A2 162 Diak FULL. Ho frea apaca laft on diak. 

$A3 163 Fatal aystem error. Elther OOS haa bug 

or bad diakatta. 

$A4 164 File miamatch. Bad fila atructura or 

POIHT valuea wrang. 

$A5 165 Bad file nana. Check for illegal char- 

acters in file nana. Veraion 4 ia mora 
liberal in thia regard than veraion 2. 

$A6 166 Tha byte count ln your POINT Call waa 

greater then 125 (for aingla denaity 
veraion 2) or 253 (for double denaity 
veraion 2). 

$A7 167 The file apecified ia locked 

(PROtected). Protected flies cannot be 
eraaed or written to. 

$A8 168 The aoftware Interface for tha apeclfic 

devica received an invalid command 
(cxaroplet tried to acceas a non- 
exiatcnt track or aector). 

$A9 169 All apace allocated for the diractory 

haa been uaed up (too many filenaraea in 
uae). 

$AA 170 The file you requested doea not appear 

on thia diakatta. 

$AB 171 You haVe tried to POINT to a byte in a 

fila that ia not OPEHed for update 
(veraion 2 only). 

$AC 172 Tried to OPEN a DOS 1 fila with DOS II 

(veraion 2 only). 

$AD 173 The diak drive haa found bad aectora 

while trying to formet the diak. 



